DB3301-T 0366.3-2022一碼通應(yīng)用規(guī)范+第3部分：服務(wù)要求

1、ICS 35.040CCS L 713301浙 江 省 杭 州 市 地 方 標(biāo) 準(zhǔn)DB 3301/T 0366.32022一碼通應(yīng)用規(guī)范 第 3 部分：服務(wù)要求2022 - 06 - 30 發(fā)布2022 - 07 - 30 實(shí)施杭州市市場監(jiān)督管理局發(fā) 布DB 3301/T 0366.32022DB 3301/T 0366.32022目次前言II引言III范圍1規(guī)范性引用文件1術(shù)語和定義1縮略語1服務(wù)場景1服務(wù)框架1一碼通用戶服務(wù)要求2業(yè)務(wù)應(yīng)用方服務(wù)要求3接口服務(wù)3附錄 A（資料性） 一碼通應(yīng)用場景5附錄 B（規(guī)范性） 接口調(diào)用方式和參數(shù)要求6附錄 C（規(guī)范性） 通用接口返回值代碼說明10I前言

2、本文件按照GB/T 1.12020標(biāo)準(zhǔn)化工作導(dǎo)則 第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則的規(guī)定起草。本文件是DB3301/T 0366一碼通應(yīng)用規(guī)范的第1部分。DB3301/T 0366已經(jīng)發(fā)布了以下部分：第 1 部分：通用要求；第 2 部分：管理要求；第 3 部分：服務(wù)要求。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。 本文件由杭州市數(shù)據(jù)資源管理局提出、歸口并組織實(shí)施。本文件起草單位：杭州市余杭區(qū)數(shù)據(jù)資源管理局、杭州余杭大數(shù)據(jù)經(jīng)營有限公司。本文件主要起草人：王維忠、高燕、周圍、鮑全貴、吳鵬程、董世聰、祝玉婷、何義勝、沈琴琴、 林兵、高勇。II引言“碼”作為個(gè)人信息

3、的載體，是應(yīng)用場景中信息互認(rèn)的有效方式。在不同場景、不同人群、不同平 臺統(tǒng)一使用碼的過程中，需要采集、存儲和處理各種數(shù)據(jù)信息，以實(shí)現(xiàn)多種場景應(yīng)用。目前用于身份識別的二維碼五花八門，不同的碼制組成和數(shù)據(jù)格式不一致、數(shù)據(jù)不共享和互認(rèn)機(jī)制 缺乏等問題，給碼的集成及應(yīng)用帶來了阻礙：用戶在不同場景需切換二維碼，操作繁瑣使用不便；業(yè)務(wù) 應(yīng)用方在建設(shè)或接入時(shí)，不同的碼標(biāo)準(zhǔn)在硬件接入過程中要求各異，可能發(fā)生業(yè)務(wù)受阻或重復(fù)建設(shè)的問 題；管理部門無法統(tǒng)一數(shù)據(jù)獲取標(biāo)準(zhǔn)，為數(shù)字化管理工作帶來困擾?；谝陨犀F(xiàn)狀，“一碼通”平臺通過構(gòu)建統(tǒng)一的標(biāo)準(zhǔn)，并結(jié)合健康碼亮碼應(yīng)用，進(jìn)而逐步搭建覆蓋全人群、全場景的碼體系。自“一碼通”

4、平臺開設(shè)試點(diǎn)以來，“碼”在交通出行、政務(wù)服務(wù)、醫(yī)療健康、 文化旅游等多個(gè)領(lǐng)域的應(yīng)用場景中發(fā)揮了巨大的作用。因此，從當(dāng)前的實(shí)踐情況和長遠(yuǎn)的應(yīng)用需求來看， 需要實(shí)現(xiàn)碼的標(biāo)準(zhǔn)一致。DB3301/T 0366旨在規(guī)定一碼通相關(guān)應(yīng)用系統(tǒng)的設(shè)計(jì)、開發(fā)和系統(tǒng)集成方面的要求。三個(gè)部分的編制目的如下：第 1 部分：通用要求，給出一碼通應(yīng)用規(guī)范的管理和服務(wù)基本原則和一碼通的基本要求；第 2 部分：管理要求，給出一碼通應(yīng)用規(guī)范的數(shù)據(jù)管理要求、運(yùn)維管理要求和安全管理要求；業(yè)務(wù)應(yīng)用方服務(wù)要求和接口服務(wù)。III第 3 部分：服務(wù)要求，給出一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、DB 3301/T 0366

5、.32022DB 3301/T 0366.32022一碼通應(yīng)用規(guī)范 第 3 部分：服務(wù)要求范圍本文件規(guī)定了一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、業(yè)務(wù)應(yīng)用方服務(wù)要求 和接口服務(wù)。本文件適用于一碼通及個(gè)人信息相關(guān)應(yīng)用系統(tǒng)的服務(wù)標(biāo)準(zhǔn)化管理。規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件， 僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。DB 3301/T 0366.1 一碼通應(yīng)用規(guī)范 第 1 部分：通用要求DB 3301/T 0366.2 一碼通應(yīng)用規(guī)范 第 2 部分：管理要求術(shù)語

6、和定義DB 3301/T 0366.1、DB 3301/T 0366.2界定的以及下列術(shù)語和定義適用于本文件。3.1應(yīng)急碼 emergency code在服務(wù)器不可用、系統(tǒng)崩潰等緊急情況下可離線使用的二維碼。4 縮略語下列縮略語適用于本文件。REST：表述性狀態(tài)轉(zhuǎn)移（Representational State Transfer） Web：全球廣域網(wǎng)（World Wide Web）5 服務(wù)場景一碼通用戶可通過移動(dòng)通信終端申領(lǐng)簡碼，用戶可憑碼進(jìn)出多種公共場所，如公園、博物館、醫(yī)院等，實(shí)現(xiàn)不同場景下的快速核驗(yàn)需求，應(yīng)用服務(wù)場景包括但不限于以下方面：一碼出行、一碼通辦、一碼入園、一碼入館、一碼就醫(yī)、

7、一碼連心、一碼入學(xué)、才金直通、三色五益、助殘助學(xué)、幸福計(jì)算器等。 具體服務(wù)場景說明見附錄A。6 服務(wù)框架1一碼通應(yīng)建立信息化服務(wù)平臺，應(yīng)具有統(tǒng)一的身份認(rèn)證、統(tǒng)一電子證照、統(tǒng)一數(shù)據(jù)交換等公共支撐服務(wù)功能。一碼通信息可服務(wù)于市民、企業(yè)、政府的生活便利、服務(wù)便利和管理便利。一碼通平臺服 務(wù)框架見圖 1。圖 1 一碼通平臺服務(wù)框架圖一碼通平臺基于底層數(shù)據(jù)庫，如互聯(lián)網(wǎng)數(shù)據(jù)、物聯(lián)網(wǎng)數(shù)據(jù)、公安數(shù)據(jù)、社保數(shù)據(jù)、醫(yī)保數(shù)據(jù)、市民卡卡管數(shù)據(jù)、健康碼數(shù)據(jù)、業(yè)務(wù)場景采集的數(shù)據(jù)等，實(shí)現(xiàn)“一碼”身份統(tǒng)一和統(tǒng)一數(shù)據(jù)管理。平臺功 能包括場景的接入管理、規(guī)則管理、場景管理、身份認(rèn)證、場景標(biāo)簽、規(guī)則引擎、硬件管理等。一碼通平臺依據(jù)

8、的數(shù)據(jù)源應(yīng)包括以下信息：用戶的身份信息：姓名、手機(jī)號碼、證件類型、證件號碼；用戶的戶籍信息：用戶的戶籍信息及所在地區(qū)的居住信息；用戶的防疫信息：用戶的國家健康碼狀態(tài)信息、用戶的新冠疫苗接種狀態(tài)信息、用戶在近期時(shí)間內(nèi)是否途徑或停留國內(nèi)存在疫情風(fēng)險(xiǎn)地區(qū)的相關(guān)信息；用戶的類別信息：用戶對應(yīng)人才引進(jìn)政策的人才級別信息、用戶是否為部隊(duì)退伍軍人的信息；其他相關(guān)信息。一碼通用戶服務(wù)要求服務(wù)流程實(shí)名認(rèn)證所有使用一碼通服務(wù)的用戶，需要通過應(yīng)用軟件進(jìn)行實(shí)名認(rèn)證，通過后進(jìn)入領(lǐng)碼操作。領(lǐng)碼領(lǐng)碼時(shí)會(huì)要求用戶進(jìn)行個(gè)人信息授權(quán)，用戶同意后，通過接入渠道的授權(quán)接口獲取到用戶個(gè)人信息。2制碼通過實(shí)名認(rèn)證與領(lǐng)碼操作的用戶，可請求

9、生成“一碼通信息碼”的二維碼，并在需要的時(shí)候出示此 碼，作為個(gè)人信息證明。主要流程包括：用戶進(jìn)行亮碼操作時(shí)，應(yīng)用軟件通過“二維碼調(diào)用申請”接口發(fā)起業(yè)務(wù)請求，再調(diào)用“個(gè)人身份標(biāo)簽”接口，獲取個(gè)人身份標(biāo)簽信息；“個(gè)人身份標(biāo)簽”接口根據(jù)用戶授權(quán)內(nèi)容返回相應(yīng)的二維碼。服務(wù)提供一碼通軟件應(yīng)具有使用端服務(wù)功能，解答用戶問詢和處理用戶投訴。當(dāng)遇到系統(tǒng)崩潰、網(wǎng)絡(luò)阻塞等一碼通功能無法正常使用的情況，應(yīng)通過軟件或短信提示等方式及時(shí)告知用戶。根據(jù)實(shí)際業(yè)務(wù)需求，在突發(fā)狀況下可提供應(yīng)急碼供用戶使用。業(yè)務(wù)應(yīng)用方服務(wù)要求服務(wù)流程業(yè)務(wù)應(yīng)用方可線上進(jìn)行使用申請，對使用場景、所需信息進(jìn)行備案登記，獲取二維碼使用類型、 用戶信息。

10、規(guī)范統(tǒng)一管理。應(yīng)用要求具體碼應(yīng)用場景由各場景業(yè)務(wù)應(yīng)用方負(fù)責(zé)，一碼通主要為不同場景提供便捷化服務(wù)，提供綜合的大數(shù)據(jù)分析比對，為各個(gè)場景提供碼標(biāo)準(zhǔn)和相關(guān)數(shù)據(jù)查詢接口服務(wù)。各場景可通過一碼通平臺的個(gè)人信息，結(jié)合場景服務(wù)，通過同一個(gè)碼面向用戶服務(wù)。各場景業(yè)務(wù)應(yīng)用方負(fù)責(zé)所轄場景碼服務(wù)的投訴處理。對接要求已建設(shè)碼的相關(guān)業(yè)務(wù)應(yīng)用方，應(yīng)按照本文件與一碼通平臺對接。各場景應(yīng)用軟件應(yīng)能識別由一碼通平臺生成的簡碼，實(shí)現(xiàn)基于一碼通平臺簡碼的互聯(lián)互通。一碼通平臺提供跨地區(qū)的個(gè)人信息查詢服 務(wù)。各業(yè)務(wù)應(yīng)用方應(yīng)在此基礎(chǔ)上，結(jié)合個(gè)人信息數(shù)據(jù)，進(jìn)行場景化應(yīng)用。尚未建設(shè)碼應(yīng)用的場景，應(yīng)直接將一碼通作為場景碼使用，提供特定的服務(wù)。

11、9 接口服務(wù)基本要求一碼通系統(tǒng)對外發(fā)布服務(wù)和接受請求應(yīng)采用符合REST架構(gòu)原則的Web服務(wù)。服務(wù)類型一碼通相關(guān)的服務(wù)類型說明見表1。3平臺應(yīng)遵循統(tǒng)一性和易用性要求，集成通用服務(wù)功能，實(shí)現(xiàn)個(gè)人信息、硬件設(shè)備和使用場景的表 1 服務(wù)類型說明序號服務(wù)類型服務(wù)名稱11000二維碼產(chǎn)生接口220000二維碼解碼接口330000第三方應(yīng)用授權(quán)接口接口管理概述接口類型及說明見表2。表 2 接口類型及說明序號接口類型接口說明名1產(chǎn)生二維碼接口生成二維碼2用戶標(biāo)簽信息查詢接口獲取一碼通用戶的標(biāo)簽信息數(shù)據(jù)3渠道二維碼接口一碼通用戶渠道請求二維碼4解碼能力接口一碼通用戶提供解碼能力接口5第三方授權(quán)接口一碼通用戶第三

12、方授權(quán)接口9.3.2 接口調(diào)用方式和參數(shù)各類型接口調(diào)用方式和參數(shù)應(yīng)符合附錄B的規(guī)定，接口返回值代碼說明應(yīng)符合附錄C的規(guī)定。4AA附 錄A（資料性） 一碼通應(yīng)用場景應(yīng)用場景服務(wù)說明如下：一碼出行,以“碼”為載體，實(shí)現(xiàn)公交、地鐵、水上巴士等各類公共交通場景的刷碼通用。同 時(shí)為人才等提供個(gè)性化服務(wù)，例如刷碼免費(fèi)乘坐指定路線公交；一碼通辦,可在行政服務(wù)中心可通過掃碼進(jìn)行預(yù)約取號和現(xiàn)場取號；一碼入園,可通過掃碼實(shí)名制進(jìn)入公園游玩；一碼入館,可通過掃碼實(shí)名制進(jìn)入博物院游玩，同步支持自助圖書館掃碼借還圖書；一碼就醫(yī),可通過掃碼在醫(yī)院和社區(qū)衛(wèi)生服務(wù)中心進(jìn)行體檢預(yù)約簽到、掃碼進(jìn)行自助基礎(chǔ)健康 監(jiān)測、購買應(yīng)急藥品

13、；一碼連心，搭建市民線上信訪快速通道，當(dāng)市民遇到問題或需要幫助時(shí)，可隨時(shí)隨地進(jìn)行咨詢或反映，是市民聯(lián)系政府的首選通道；一碼入學(xué)，緊貼市民入學(xué)需求，市民可精準(zhǔn)及時(shí)了解教育資源供給，招生入學(xué)等政策信息， 強(qiáng)化市民對于教育信息的有效獲取、教育政策的正確理解、未來需求的準(zhǔn)確預(yù)期等。才金直通，被標(biāo)記的人才通過掃碼或亮碼，可實(shí)現(xiàn)人才政策“一鍵兌現(xiàn)”、人才辦事“一站入口”、人才雙創(chuàng)“一幫到底”、人才服務(wù)“一碼供給”；從業(yè)人員通過紅、黃、藍(lán)三色賦碼管理，市民可進(jìn)行特定行業(yè)從業(yè)限制查詢；助殘助學(xué)，幫助全教育階段殘疾學(xué)生在線申請就學(xué)補(bǔ)助，同時(shí)也幫助他們解決日常學(xué)習(xí)和生活中遇到的各類問題；幸福計(jì)算器，市民可直接檢索

14、滿足自身資質(zhì)可享受到的優(yōu)惠政策，將福利政策直達(dá)市民，打通政府與市民之間的最后一公里，提高主動(dòng)服務(wù)和精準(zhǔn)服務(wù)的力度。5三色五益，對醫(yī)療衛(wèi)生、食品藥品、教育培訓(xùn)、公交客運(yùn)、養(yǎng)老服務(wù)等五大民生公益領(lǐng)域的BB附 錄B（規(guī)范性）接口調(diào)用方式和參數(shù)要求產(chǎn)生二維碼接口調(diào)用方式產(chǎn)生二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求產(chǎn)生二維碼接口參數(shù)要求見表B.1。表 B.1 產(chǎn)生二維碼接口參數(shù)要求類別參數(shù)是否必填數(shù)據(jù)類型說明輸入?yún)?shù)accessToken是字符串用戶授權(quán)后的渠道令牌輸入?yún)?shù)latitude是字符串緯度輸入?yún)?shù)longitude是字符串經(jīng)度輸出參數(shù)code是字符串返回值代碼輸出參數(shù)message是字

15、符串返回情況說明輸出參數(shù)concealCard是字符串脫敏的用戶身份證號碼輸出參數(shù)concealName是字符串脫敏的用戶姓名輸出參數(shù)qrcodeBase64是字符串二維碼base64 字符串輸出參數(shù)qrcodeType是字符串二維碼類型輸出參數(shù)serverTime是時(shí)間服務(wù)器時(shí)間返回?cái)?shù)據(jù)格式統(tǒng)一采用字符串格式：示例：code: PY0000,msg: 成功, response: qrcodeType: gj,qrcodeBase64: iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=, serverTime: 2021-09-16 20:12:00,conceal

16、Name: *嚴(yán),concealCard: 5*46用戶標(biāo)簽信息查詢接口調(diào)用方式用戶標(biāo)簽信息查詢接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求用戶標(biāo)簽信息查詢接口參數(shù)要求見表B.2。表 B.2 用戶標(biāo)簽信息查詢接口參數(shù)要求類別參數(shù)是否必填數(shù)據(jù)類型說明輸入?yún)?shù)accessToken是字符串用戶授權(quán)后的渠道令牌輸出參數(shù)code是字符串返回值代碼輸出參數(shù)message是字符串返回情況說明輸出參數(shù)Icon是字符串返回的填 icon 圖片地址輸出參數(shù)no是整數(shù)標(biāo)簽序號輸出參數(shù)text是字符串標(biāo)簽的文本內(nèi)容輸出參數(shù)backgroundColor是整數(shù)返回的標(biāo)簽底色顏色枚舉值輸出參數(shù)fontColor是整數(shù)返回的

17、字體顏色枚舉值返回?cái)?shù)據(jù)格式統(tǒng)一采用字符串格式：示例：code: PY0000,msg: 成功, response: icon:/yikayima/yhqrcode/202108/cda2a451-df06-4d40-be5b-d3851828 1d10.png,no: 1,backgroundColor: 1, text: 退役軍人, fontColor: 1,icon:/yikayima/yhqrcode/202108/f7fb8c7d-63c8-4218-9748-e98a6f0a 13e1.png,no: 4,backgroundColor: 1 text: E類人才, fontColo

18、r: 17返回?cái)?shù)據(jù)格式統(tǒng)一采用字符串格式：示例：code: PY0000,msg: 成功, response: qrcodeType: gj,qrcodeBase64: iVBORw*kSuQmCC, idCard: serverTime: 2021-09-16 12:39:04,userName: 張三,concealName: * 三 , concealCard: 3*X解碼能力接口調(diào)用方式解碼能力接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。8渠道二維碼接口調(diào)用方式渠道二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求渠道二維碼接口參數(shù)要求見表B.3。表 B.3 渠

19、道二維碼接口參數(shù)要求類別參數(shù)是否必填數(shù)據(jù)類型說明輸入?yún)?shù)accessToken是字符串用戶授權(quán)后的渠道令牌輸入?yún)?shù)longitude是字符串經(jīng)度輸入?yún)?shù)latitude是字符串維度輸出參數(shù)code是字符串返回值代碼輸出參數(shù)message是字符串返回情況說明輸出參數(shù)qrcodeType是字符串公交碼類型輸出參數(shù)qrcodeBase64是字符串二維碼 base64 加密字符串輸出參數(shù)idCard是字符串用戶身份證輸出參數(shù)serverTime是字符串請求時(shí)間輸出參數(shù)userNmae是字符串用戶姓名輸出參數(shù)concelName是字符串用戶脫敏姓名輸出參數(shù)concelCard是字符串用戶脫敏身份證B.4.2 參數(shù)要求解碼能力接口參數(shù)要求見表B.4。表 B.4 解碼能力接口參數(shù)要求類別參數(shù)是否必填數(shù)據(jù)類型說明輸入?yún)?shù)merchantId是字符串商戶 id輸入?yún)?shù)time是字符串時(shí)間字符串 yyyyMMssHHmmss輸入?yún)?shù)sign是字符串RSA 簽名輸入?yún)?shù)qrcod是字符串二維碼值輸入?yún)?shù)macId是字符串設(shè)備編號輸出參數(shù)re