ICS35.040

CCSL71

3301

浙江省杭州市地方標準

DB3301/T0366.3—2022

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

2022-06-30發(fā)布2022-07-30實施

杭州市市場監(jiān)督管理局??發(fā)布

DB3301/T0366.3—2022

目次

前言..................................................................................II

引言.................................................................................III

1范圍................................................................................1

2規(guī)范性引用文件......................................................................1

3術(shù)語和定義..........................................................................1

4縮略語..............................................................................1

5服務(wù)場景............................................................................1

6服務(wù)框架............................................................................1

7一碼通用戶服務(wù)要求..................................................................2

8業(yè)務(wù)應(yīng)用方服務(wù)要求..................................................................3

9接口服務(wù)............................................................................3

附錄A（資料性）一碼通應(yīng)用場景........................................................5

附錄B（規(guī)范性）接口調(diào)用方式和參數(shù)要求................................................6

附錄C（規(guī)范性）通用接口返回值代碼說明...............................................10

I

DB3301/T0366.3—2022

前言

本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件是DB3301/T0366《一碼通應(yīng)用規(guī)范》的第1部分。DB3301/T0366已經(jīng)發(fā)布了以下部分：

——第1部分：通用要求；

——第2部分：管理要求；

——第3部分：服務(wù)要求。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責(zé)任。

本文件由杭州市數(shù)據(jù)資源管理局提出、歸口并組織實施。

本文件起草單位：杭州市余杭區(qū)數(shù)據(jù)資源管理局、杭州余杭大數(shù)據(jù)經(jīng)營有限公司。

本文件主要起草人：王維忠、高燕、周圍、鮑全貴、吳鵬程、董世聰、祝玉婷、何義勝、沈琴琴、

林兵、高勇。

II

DB3301/T0366.3—2022

引言

“碼”作為個人信息的載體，是應(yīng)用場景中信息互認的有效方式。在不同場景、不同人群、不同平

臺統(tǒng)一使用碼的過程中，需要采集、存儲和處理各種數(shù)據(jù)信息，以實現(xiàn)多種場景應(yīng)用。

目前用于身份識別的二維碼五花八門，不同的碼制組成和數(shù)據(jù)格式不一致、數(shù)據(jù)不共享和互認機制

缺乏等問題，給碼的集成及應(yīng)用帶來了阻礙：用戶在不同場景需切換二維碼，操作繁瑣使用不便；業(yè)務(wù)

應(yīng)用方在建設(shè)或接入時，不同的碼標準在硬件接入過程中要求各異，可能發(fā)生業(yè)務(wù)受阻或重復(fù)建設(shè)的問

題；管理部門無法統(tǒng)一數(shù)據(jù)獲取標準，為數(shù)字化管理工作帶來困擾。

基于以上現(xiàn)狀，“一碼通”平臺通過構(gòu)建統(tǒng)一的標準，并結(jié)合健康碼亮碼應(yīng)用，進而逐步搭建覆蓋

全人群、全場景的碼體系。自“一碼通”平臺開設(shè)試點以來，“碼”在交通出行、政務(wù)服務(wù)、醫(yī)療健康、

文化旅游等多個領(lǐng)域的應(yīng)用場景中發(fā)揮了巨大的作用。因此，從當前的實踐情況和長遠的應(yīng)用需求來看，

需要實現(xiàn)碼的標準一致。

DB3301/T0366旨在規(guī)定一碼通相關(guān)應(yīng)用系統(tǒng)的設(shè)計、開發(fā)和系統(tǒng)集成方面的要求。三個部分的編

制目的如下：

——第1部分：通用要求，給出一碼通應(yīng)用規(guī)范的管理和服務(wù)基本原則和一碼通的基本要求；

——第2部分：管理要求，給出一碼通應(yīng)用規(guī)范的數(shù)據(jù)管理要求、運維管理要求和安全管理要求；

——第3部分：服務(wù)要求，給出一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、

業(yè)務(wù)應(yīng)用方服務(wù)要求和接口服務(wù)。

III

DB3301/T0366.3—2022

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

1范圍

本文件規(guī)定了一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、業(yè)務(wù)應(yīng)用方服務(wù)要求

和接口服務(wù)。

本文件適用于一碼通及個人信息相關(guān)應(yīng)用系統(tǒng)的服務(wù)標準化管理。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

DB3301/T0366.1一碼通應(yīng)用規(guī)范第1部分：通用要求

DB3301/T0366.2一碼通應(yīng)用規(guī)范第2部分：管理要求

3術(shù)語和定義

DB3301/T0366.1、DB3301/T0366.2界定的以及下列術(shù)語和定義適用于本文件。

3.1

應(yīng)急碼emergencycode

在服務(wù)器不可用、系統(tǒng)崩潰等緊急情況下可離線使用的二維碼。

4縮略語

下列縮略語適用于本文件。

REST：表述性狀態(tài)轉(zhuǎn)移（RepresentationalStateTransfer）

Web：全球廣域網(wǎng)（WorldWideWeb）

5服務(wù)場景

一碼通用戶可通過移動通信終端申領(lǐng)簡碼，用戶可憑碼進出多種公共場所，如公園、博物館、醫(yī)院

等，實現(xiàn)不同場景下的快速核驗需求，應(yīng)用服務(wù)場景包括但不限于以下方面：一碼出行、一碼通辦、一

碼入園、一碼入館、一碼就醫(yī)、一碼連心、一碼入學(xué)、才金直通、三色五益、助殘助學(xué)、幸福計算器等。

具體服務(wù)場景說明見附錄A。

6服務(wù)框架

1

DB3301/T0366.3—2022

6.1一碼通應(yīng)建立信息化服務(wù)平臺，應(yīng)具有統(tǒng)一的身份認證、統(tǒng)一電子證照、統(tǒng)一數(shù)據(jù)交換等公共支

撐服務(wù)功能。一碼通信息可服務(wù)于市民、企業(yè)、政府的生活便利、服務(wù)便利和管理便利。一碼通平臺服

務(wù)框架見圖1。

圖1一碼通平臺服務(wù)框架圖

6.2一碼通平臺基于底層數(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ù)等，實現(xiàn)“一碼”身份統(tǒng)一和統(tǒng)一數(shù)據(jù)管理。平臺功

能包括場景的接入管理、規(guī)則管理、場景管理、身份認證、場景標簽、規(guī)則引擎、硬件管理等。

6.3一碼通平臺依據(jù)的數(shù)據(jù)源應(yīng)包括以下信息：

a)用戶的身份信息：姓名、手機號碼、證件類型、證件號碼；

b)用戶的戶籍信息：用戶的戶籍信息及所在地區(qū)的居住信息；

c)用戶的防疫信息：用戶的國家健康碼狀態(tài)信息、用戶的新冠疫苗接種狀態(tài)信息、用戶在近期

時間內(nèi)是否途徑或停留國內(nèi)存在疫情風(fēng)險地區(qū)的相關(guān)信息；

d)用戶的類別信息：用戶對應(yīng)人才引進政策的人才級別信息、用戶是否為部隊退伍軍人的信息；

e)其他相關(guān)信息。

7一碼通用戶服務(wù)要求

7.1服務(wù)流程

7.1.1實名認證

所有使用一碼通服務(wù)的用戶，需要通過應(yīng)用軟件進行實名認證，通過后進入領(lǐng)碼操作。

7.1.2領(lǐng)碼

領(lǐng)碼時會要求用戶進行個人信息授權(quán)，用戶同意后，通過接入渠道的授權(quán)接口獲取到用戶個人信息。

2

DB3301/T0366.3—2022

7.1.3制碼

通過實名認證與領(lǐng)碼操作的用戶，可請求生成“一碼通信息碼”的二維碼，并在需要的時候出示此

碼，作為個人信息證明。主要流程包括：

a)用戶進行亮碼操作時，應(yīng)用軟件通過“二維碼調(diào)用申請”接口發(fā)起業(yè)務(wù)請求，再調(diào)用“個人

身份標簽”接口，獲取個人身份標簽信息；

b)“個人身份標簽”接口根據(jù)用戶授權(quán)內(nèi)容返回相應(yīng)的二維碼。

7.2服務(wù)提供

7.2.1一碼通軟件應(yīng)具有使用端服務(wù)功能，解答用戶問詢和處理用戶投訴。

7.2.2當遇到系統(tǒng)崩潰、網(wǎng)絡(luò)阻塞等一碼通功能無法正常使用的情況，應(yīng)通過軟件或短信提示等方式

及時告知用戶。根據(jù)實際業(yè)務(wù)需求，在突發(fā)狀況下可提供應(yīng)急碼供用戶使用。

8業(yè)務(wù)應(yīng)用方服務(wù)要求

8.1服務(wù)流程

8.1.1業(yè)務(wù)應(yīng)用方可線上進行使用申請，對使用場景、所需信息進行備案登記，獲取二維碼使用類型、

用戶信息。

8.1.2平臺應(yīng)遵循統(tǒng)一性和易用性要求，集成通用服務(wù)功能，實現(xiàn)個人信息、硬件設(shè)備和使用場景的

規(guī)范統(tǒng)一管理。

8.2應(yīng)用要求

8.2.1具體碼應(yīng)用場景由各場景業(yè)務(wù)應(yīng)用方負責(zé)，一碼通主要為不同場景提供便捷化服務(wù)，提供綜合

的大數(shù)據(jù)分析比對，為各個場景提供碼標準和相關(guān)數(shù)據(jù)查詢接口服務(wù)。

8.2.2各場景可通過一碼通平臺的個人信息，結(jié)合場景服務(wù)，通過同一個碼面向用戶服務(wù)。

8.2.3各場景業(yè)務(wù)應(yīng)用方負責(zé)所轄場景碼服務(wù)的投訴處理。

8.3對接要求

8.3.1已建設(shè)碼的相關(guān)業(yè)務(wù)應(yīng)用方，應(yīng)按照本文件與一碼通平臺對接。各場景應(yīng)用軟件應(yīng)能識別由一

碼通平臺生成的簡碼，實現(xiàn)基于一碼通平臺簡碼的互聯(lián)互通。一碼通平臺提供跨地區(qū)的個人信息查詢服

務(wù)。各業(yè)務(wù)應(yīng)用方應(yīng)在此基礎(chǔ)上，結(jié)合個人信息數(shù)據(jù)，進行場景化應(yīng)用。

8.3.2尚未建設(shè)碼應(yīng)用的場景，應(yīng)直接將一碼通作為場景碼使用，提供特定的服務(wù)。

9接口服務(wù)

9.1基本要求

一碼通系統(tǒng)對外發(fā)布服務(wù)和接受請求應(yīng)采用符合REST架構(gòu)原則的Web服務(wù)。

9.2服務(wù)類型

一碼通相關(guān)的服務(wù)類型說明見表1。

3

DB3301/T0366.3—2022

表1服務(wù)類型說明

序號服務(wù)類型服務(wù)名稱

11000二維碼產(chǎn)生接口

220000二維碼解碼接口

330000第三方應(yīng)用授權(quán)接口

9.3接口管理

9.3.1概述

接口類型及說明見表2。

表2接口類型及說明

序號接口類型接口說明名

1產(chǎn)生二維碼接口生成二維碼

2用戶標簽信息查詢接口獲取一碼通用戶的標簽信息數(shù)據(jù)

3渠道二維碼接口一碼通用戶渠道請求二維碼

4解碼能力接口一碼通用戶提供解碼能力接口

5第三方授權(quán)接口一碼通用戶第三方授權(quán)接口

9.3.2接口調(diào)用方式和參數(shù)

各類型接口調(diào)用方式和參數(shù)應(yīng)符合附錄B的規(guī)定，接口返回值代碼說明應(yīng)符合附錄C的規(guī)定。

4

DB3301/T0366.3—2022

A

A

附錄A

（資料性）

一碼通應(yīng)用場景

應(yīng)用場景服務(wù)說明如下：

a)一碼出行,以“碼”為載體，實現(xiàn)公交、地鐵、水上巴士等各類公共交通場景的刷碼通用。同

時為人才等提供個性化服務(wù)，例如刷碼免費乘坐指定路線公交；

b)一碼通辦,可在行政服務(wù)中心可通過掃碼進行預(yù)約取號和現(xiàn)場取號；

c)一碼入園,可通過掃碼實名制進入公園游玩；

d)一碼入館,可通過掃碼實名制進入博物院游玩，同步支持自助圖書館掃碼借還圖書；

e)一碼就醫(yī),可通過掃碼在醫(yī)院和社區(qū)衛(wèi)生服務(wù)中心進行體檢預(yù)約簽到、掃碼進行自助基礎(chǔ)健康

監(jiān)測、購買應(yīng)急藥品；

f)一碼連心，搭建市民線上信訪快速通道，當市民遇到問題或需要幫助時，可隨時隨地進行咨

詢或反映，是市民聯(lián)系政府的首選通道；

g)一碼入學(xué)，緊貼市民入學(xué)需求，市民可精準及時了解教育資源供給，招生入學(xué)等政策信息，

強化市民對于教育信息的有效獲取、教育政策的正確理解、未來需求的準確預(yù)期等。

h)才金直通，被標記的人才通過掃碼或亮碼，可實現(xiàn)人才政策“一鍵兌現(xiàn)”、人才辦事“一站

入口”、人才雙創(chuàng)“一幫到底”、人才服務(wù)“一碼供給”；

i)三色五益，對醫(yī)療衛(wèi)生、食品藥品、教育培訓(xùn)、公交客運、養(yǎng)老服務(wù)等五大民生公益領(lǐng)域的

從業(yè)人員通過紅、黃、藍三色賦碼管理，市民可進行特定行業(yè)從業(yè)限制查詢；

j)助殘助學(xué)，幫助全教育階段殘疾學(xué)生在線申請就學(xué)補助，同時也幫助他們解決日常學(xué)習(xí)和生

活中遇到的各類問題；

k)幸福計算器，市民可直接檢索滿足自身資質(zhì)可享受到的優(yōu)惠政策，將福利政策直達市民，打

通政府與市民之間的最后一公里，提高主動服務(wù)和精準服務(wù)的力度。

5

DB3301/T0366.3—2022

B

B

附錄B

（規(guī)范性）

接口調(diào)用方式和參數(shù)要求

B.1產(chǎn)生二維碼接口

B.1.1調(diào)用方式

產(chǎn)生二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。

B.1.2參數(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是字符串返回情況說明

輸出參數(shù)concealCard是字符串脫敏的用戶身份證號碼

輸出參數(shù)concealName是字符串脫敏的用戶姓名

輸出參數(shù)qrcodeBase64是字符串二維碼base64字符串

輸出參數(shù)qrcodeType是字符串二維碼類型

輸出參數(shù)serverTime是時間服務(wù)器時間

返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":{

"qrcodeType":"gj",

"qrcodeBase64":"iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=",

"serverTime":"2021-09-1620:12:00",

嚴

"concealName":"*",

"concealCard":"5**************4"

}

}

6

DB3301/T0366.3—2022

B.2用戶標簽信息查詢接口

B.2.1調(diào)用方式

用戶標簽信息查詢接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。

B.2.2參數(shù)要求

用戶標簽信息查詢接口參數(shù)要求見表B.2。

表B.2用戶標簽信息查詢接口參數(shù)要求

類別參數(shù)是否必填數(shù)據(jù)類型說明

輸入?yún)?shù)accessToken是字符串用戶授權(quán)后的渠道令牌

輸出參數(shù)code是字符串返回值代碼

輸出參數(shù)message是字符串返回情況說明

輸出參數(shù)Icon是字符串返回的填icon圖片地址

輸出參數(shù)no是整數(shù)標簽序號

輸出參數(shù)text是字符串標簽的文本內(nèi)容

輸出參數(shù)backgroundColor是整數(shù)返回的標簽底色顏色枚舉值

輸出參數(shù)fontColor是整數(shù)返回的字體顏色枚舉值

返回數(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",

"fontColor":1

}

]

}

7

DB3301/T0366.3—2022

B.3渠道二維碼接口

B.3.1調(diào)用方式

渠道二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。

B.3.2參數(shù)要求

渠道二維碼接口參數(shù)要求見表B.3。

表B.3渠道二維碼接口參數(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ù)userNmae是字符串用戶姓名

輸出參數(shù)concelName是字符串用戶脫敏姓名

輸出參數(shù)concelCard是字符串用戶脫敏身份證

返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":{

"qrcodeType":"gj",

"qrcodeBase64":"iVBORw*************kSuQmCC",

"idCard":,

"serverTime":"2021-09-1612:39:04",

張三

"userName":"",

三

"concealName":"*",

"concealCard":"3**************X"

}

}

B.4解碼能力接口

B.4.1調(diào)用方式

解碼能力接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。

8

DB3301/T0366.3—2022

B.4.2參數(shù)要求

解碼能力接口參數(shù)要求見表B.4。

表B.4解碼能力接口參數(shù)要求

類別參數(shù)是否必填數(shù)據(jù)類型說明

輸入?yún)?shù)merchantId是字符串商戶id

輸入?yún)?shù)time是字符串時間字符串yyyyMMssHHmmss

輸入?yún)?shù)sign是字符串RSA簽名

輸入?yún)?shù)qrcod是字符串二維碼值

輸入?yún)?shù)macId是字符串設(shè)備編號

輸出參數(shù)response是字符串AES加密的傳輸信息

返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":

"spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgadosfjadoasfiopajsgoipasnfg

aposndapodfsjfiopasncoapsdichpsaojgdioaspjfviandsopfjaiopsndfvoiapsndvioaspnvapngvudaf

gioansvpasnfiajopdjfaisudjfpfgasjdfaiponcioapngoaphasd"

}

B.5第三方授權(quán)接口

B.5.1調(diào)用方式

第三方授權(quán)接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。

B.5.2參數(shù)要求

第三方授權(quán)接口參數(shù)要求見表B.5。