DBXX/TXXXX—XXXX

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

1范圍

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

和接口服務。

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

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

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

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

文件。

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

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

3術(shù)語和定義

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

應急碼emergencycode

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

4縮略語

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

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

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

5服務場景

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

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

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

具體服務場景說明見附錄A。

6服務框架

1

DBXX/TXXXX—XXXX

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

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

務框架見圖1。

圖1一碼通平臺服務框架圖

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

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

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

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

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

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

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

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

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

7一碼通用戶服務要求

服務流程

7.1.1實名認證

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

7.1.2領(lǐng)碼

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

2

DBXX/TXXXX—XXXX

7.1.3制碼

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

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

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

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

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

服務提供

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

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

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

8業(yè)務應用方服務要求

服務流程

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

用戶信息。

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

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

應用要求

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

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

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

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

對接要求

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

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

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

8.3.2尚未建設碼應用的場景，應直接將一碼通作為場景碼使用，提供特定的服務。

9接口服務

基本要求

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

服務類型

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

3

DBXX/TXXXX—XXXX

表1服務類型說明

序號服務類型服務名稱

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

220000二維碼解碼接口

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

接口管理

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ù)應符合附錄B的規(guī)定，接口返回值代碼說明應符合附錄C的規(guī)定。

4

DBXX/TXXXX—XXXX

A

A

附錄A

（資料性）

一碼通應用場景

應用場景服務說明如下：

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

活中遇到的各類問題；

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

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

5

DBXX/TXXXX—XXXX

B

B

附錄B

（規(guī)范性）

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

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

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

產(chǎn)生二維碼接口應通過互聯(lián)網(wǎng)或政務外網(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是時間服務器時間

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

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":{

"qrcodeType":"gj",

"qrcodeBase64":"iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=",

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

嚴

"concealName":"*",

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

}

}

6

DBXX/TXXXX—XXXX

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

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

用戶標簽信息查詢接口應通過互聯(lián)網(wǎng)或政務外網(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

DBXX/TXXXX—XXXX

B.3渠道二維碼接口

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

渠道二維碼接口應通過互聯(lián)網(wǎng)或政務外網(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)用方式

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

8

DBXX/TXXXX—XXXX

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ù)response是字符串AES加密的傳輸信息

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

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":

"spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgadosfjadoasfiopajsgoipasnfg

aposndapodfsjfiopasncoapsdichpsaojgdioaspjfviandsopfjaiopsndfvoiapsndvioaspnvapngvudaf

gioansvpasnfiajopdjfaisudjfpfgasjdfaiponcioapngoaphasd"

}

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

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

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

B.5.2參數(shù)要求

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

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

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

輸入?yún)?shù)code是字符串第三方授權(quán)code

輸入?yún)?shù)appId是字符串應用唯一標