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í)施杭州市市場(chǎng)監(jiān)督管理局發(fā) 布DB 3301/T 0366.32022DB 3301/T 0366.32022目次前言II引言III范圍1規(guī)范性引用文件1術(shù)語(yǔ)和定義1縮略語(yǔ)1服務(wù)場(chǎng)景1服務(wù)框架1一碼通用戶(hù)服務(wù)要求2業(yè)務(wù)應(yīng)用方服務(wù)要求3接口服務(wù)3附錄 A（資料性） 一碼通應(yīng)用場(chǎng)景5附錄 B（規(guī)范性） 接口調(diào)用方式和參數(shù)要求6附錄 C（規(guī)范性） 通用接口返回值代碼說(shuō)明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ù)要求。請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。 本文件由杭州市數(shù)據(jù)資源管理局提出、歸口并組織實(shí)施。本文件起草單位：杭州市余杭區(qū)數(shù)據(jù)資源管理局、杭州余杭大數(shù)據(jù)經(jīng)營(yíng)有限公司。本文件主要起草人：王維忠、高燕、周?chē)?、鮑全貴、吳鵬程、董世聰、祝玉婷、何義勝、沈琴琴、 林兵、高勇。II引言“碼”作為個(gè)人信息

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

4、平臺(tái)開(kāi)設(shè)試點(diǎn)以來(lái)，“碼”在交通出行、政務(wù)服務(wù)、醫(yī)療健康、 文化旅游等多個(gè)領(lǐng)域的應(yīng)用場(chǎng)景中發(fā)揮了巨大的作用。因此，從當(dāng)前的實(shí)踐情況和長(zhǎng)遠(yuǎn)的應(yīng)用需求來(lái)看， 需要實(shí)現(xiàn)碼的標(biāo)準(zhǔn)一致。DB3301/T 0366旨在規(guī)定一碼通相關(guān)應(yīng)用系統(tǒng)的設(shè)計(jì)、開(kāi)發(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ù)場(chǎng)景、服務(wù)框架、一碼通用戶(hù)服務(wù)要求、DB 3301/T 0366

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

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

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

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

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

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

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

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

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

14、滿(mǎn)足自身資質(zhì)可享受到的優(yōu)惠政策，將福利政策直達(dá)市民，打通政府與市民之間的最后一公里，提高主動(dòng)服務(wù)和精準(zhǔn)服務(wù)的力度。5三色五益，對(duì)醫(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)通過(guò)互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求產(chǎn)生二維碼接口參數(shù)要求見(jiàn)表B.1。表 B.1 產(chǎn)生二維碼接口參數(shù)要求類(lèi)別參數(shù)是否必填數(shù)據(jù)類(lèi)型說(shuō)明輸入?yún)?shù)accessToken是字符串用戶(hù)授權(quán)后的渠道令牌輸入?yún)?shù)latitude是字符串緯度輸入?yún)?shù)longitude是字符串經(jīng)度輸出參數(shù)code是字符串返回值代碼輸出參數(shù)message是字

15、符串返回情況說(shuō)明輸出參數(shù)concealCard是字符串脫敏的用戶(hù)身份證號(hào)碼輸出參數(shù)concealName是字符串脫敏的用戶(hù)姓名輸出參數(shù)qrcodeBase64是字符串二維碼base64 字符串輸出參數(shù)qrcodeType是字符串二維碼類(lèi)型輸出參數(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用戶(hù)標(biāo)簽信息查詢(xún)接口調(diào)用方式用戶(hù)標(biāo)簽信息查詢(xún)接口應(yīng)通過(guò)互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求用戶(hù)標(biāo)簽信息查詢(xún)接口參數(shù)要求見(jiàn)表B.2。表 B.2 用戶(hù)標(biāo)簽信息查詢(xún)接口參數(shù)要求類(lèi)別參數(shù)是否必填數(shù)據(jù)類(lèi)型說(shuō)明輸入?yún)?shù)accessToken是字符串用戶(hù)授權(quán)后的渠道令牌輸出參數(shù)code是字符串返回值代碼輸出參數(shù)message是字符串返回情況說(shuō)明輸出參數(shù)Icon是字符串返回的填 icon 圖片地址輸出參數(shù)no是整數(shù)標(biāo)簽序號(hà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類(lèi)人才, 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)通過(guò)互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。8渠道二維碼接口調(diào)用方式渠道二維碼接口應(yīng)通過(guò)互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。參數(shù)要求渠道二維碼接口參數(shù)要求見(jiàn)表B.3。表 B.3 渠

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