一码通应用规范 第 3 部分：服务要求

DBXX/TXXXX—XXXX

一码通应用规范第3部分：服务要求

1范围

本文件规定了一码通应用规范的服务场景、服务框架、一码通用户服务要求、业务应用方服务要求

和接口服务。

本文件适用于一码通及个人信息相关应用系统的服务标准化管理。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

DB3301/TXXXX一码通应用规范第1部分：通用要求

DB3301/TXXXX一码通应用规范第2部分：管理要求

3术语和定义

DB3301/TXXXX.1、DB3301/TXXXX.2界定的以及下列术语和定义适用于本文件。

应急码emergencycode

在服务器不可用、系统崩溃等紧急情况下可离线使用的二维码。

4缩略语

下列缩略语适用于本文件。

REST：表述性状态转移（RepresentationalStateTransfer）

Web：全球广域网（WorldWideWeb）

5服务场景

一码通用户可通过移动通信终端申领简码，用户可凭码进出多种公共场所，如公园、博物馆、医院

等，实现不同场景下的快速核验需求，应用服务场景包括但不限于以下方面：一码出行、一码通办、一

码入园、一码入馆、一码就医、一码连心、一码入学、才金直通、三色五益、助残助学、幸福计算器等。

具体服务场景说明见附录A。

6服务框架

1

DBXX/TXXXX—XXXX

一码通应建立信息化服务平台，应具有统一的身份认证、统一电子证照、统一数据交换等公共支

撑服务功能。一码通信息可服务于市民、企业、政府的生活便利、服务便利和管理便利。一码通平台服

务框架见图1。

图1一码通平台服务框架图

一码通平台基于底层数据库，如互联网数据、物联网数据、公安数据、社保数据、医保数据、市

民卡卡管数据、健康码数据、业务场景采集的数据等，实现“一码”身份统一和统一数据管理。平台功

能包括场景的接入管理、规则管理、场景管理、身份认证、场景标签、规则引擎、硬件管理等。

一码通平台依据的数据源应包括以下信息：

a)用户的身份信息：姓名、手机号码、证件类型、证件号码；

b)用户的户籍信息：用户的户籍信息及所在地区的居住信息；

c)用户的防疫信息：用户的国家健康码状态信息、用户的新冠疫苗接种状态信息、用户在近期

时间内是否途径或停留国内存在疫情风险地区的相关信息；

d)用户的类别信息：用户对应人才引进政策的人才级别信息、用户是否为部队退伍军人的信息；

e)其他相关信息。

7一码通用户服务要求

服务流程

7.1.1实名认证

所有使用一码通服务的用户，需要通过应用软件进行实名认证，通过后进入领码操作。

7.1.2领码

领码时会要求用户进行个人信息授权，用户同意后，通过接入渠道的授权接口获取到用户个人信息。

2

DBXX/TXXXX—XXXX

7.1.3制码

通过实名认证与领码操作的用户，可请求生成“一码通信息码”的二维码，并在需要的时候出示此

码，作为个人信息证明。主要流程包括：

a)用户进行亮码操作时，应用软件通过“二维码调用申请”接口发起业务请求，再调用“个人

身份标签”接口，获取个人身份标签信息；

b)“个人身份标签”接口根据用户授权内容返回相应的二维码。

服务提供

7.2.1一码通软件应具有使用端服务功能，解答用户问询和处理用户投诉。

7.2.2当遇到系统崩溃、网络阻塞等一码通功能无法正常使用的情况，应通过软件或短信提示等方式

及时告知用户。根据实际业务需求，在突发状况下可提供应急码供用户使用。

8业务应用方服务要求

服务流程

8.1.1业务应用方可线上进行使用申请，对使用场景、所需信息进行备案登记，获取二维码使用类型、

用户信息。

8.1.2平台应遵循统一性和易用性要求，集成通用服务功能，实现个人信息、硬件设备和使用场景的

规范统一管理。

应用要求

8.2.1具体码应用场景由各场景业务应用方负责，一码通主要为不同场景提供便捷化服务，提供综合

的大数据分析比对，为各个场景提供码标准和相关数据查询接口服务。

8.2.2各场景可通过一码通平台的个人信息，结合场景服务，通过同一个码面向用户服务。

8.2.3各场景业务应用方负责所辖场景码服务的投诉处理。

对接要求

8.3.1已建设码的相关业务应用方，应按照本文件与一码通平台对接。各场景应用软件应能识别由一

码通平台生成的简码，实现基于一码通平台简码的互联互通。一码通平台提供跨地区的个人信息查询服

务。各业务应用方应在此基础上，结合个人信息数据，进行场景化应用。

8.3.2尚未建设码应用的场景，应直接将一码通作为场景码使用，提供特定的服务。

9接口服务

基本要求

一码通系统对外发布服务和接受请求应采用符合REST架构原则的Web服务。

服务类型

一码通相关的服务类型说明见表1。

3

DBXX/TXXXX—XXXX

表1服务类型说明

序号服务类型服务名称

11000二维码产生接口

220000二维码解码接口

330000第三方应用授权接口

接口管理

9.3.1概述

接口类型及说明见表2。

表2接口类型及说明

序号接口类型接口说明名

1产生二维码接口生成二维码

2用户标签信息查询接口获取一码通用户的标签信息数据

3渠道二维码接口一码通用户渠道请求二维码

4解码能力接口一码通用户提供解码能力接口

5第三方授权接口一码通用户第三方授权接口

9.3.2接口调用方式和参数

各类型接口调用方式和参数应符合附录B的规定，接口返回值代码说明应符合附录C的规定。

4

DBXX/TXXXX—XXXX

A

A

附录A

（资料性）

一码通应用场景

应用场景服务说明如下：

a)一码出行,以“码”为载体，实现公交、地铁、水上巴士等各类公共交通场景的刷码通用。同

时为人才等提供个性化服务，例如刷码免费乘坐指定路线公交；

b)一码通办,可在行政服务中心可通过扫码进行预约取号和现场取号；

c)一码入园,可通过扫码实名制进入公园游玩；

d)一码入馆,可通过扫码实名制进入博物院游玩，同步支持自助图书馆扫码借还图书；

e)一码就医,可通过扫码在医院和社区卫生服务中心进行体检预约签到、扫码进行自助基础健康

监测、购买应急药品；

f)一码连心，搭建市民线上信访快速通道，当市民遇到问题或需要帮助时，可随时随地进行咨

询或反映，是市民联系政府的首选通道；

g)一码入学，紧贴市民入学需求，市民可精准及时了解教育资源供给，招生入学等政策信息，

强化市民对于教育信息的有效获取、教育政策的正确理解、未来需求的准确预期等。

h)才金直通，被标记的人才通过扫码或亮码，可实现人才政策“一键兑现”、人才办事“一站

入口”、人才双创“一帮到底”、人才服务“一码供给”；

i)三色五益，对医疗卫生、食品药品、教育培训、公交客运、养老服务等五大民生公益领域的

从业人员通过红、黄、蓝三色赋码管理，市民可进行特定行业从业限制查询；

j)助残助学，帮助全教育阶段残疾学生在线申请就学补助，同时也帮助他们解决日常学习和生

活中遇到的各类问题；

k)幸福计算器，市民可直接检索满足自身资质可享受到的优惠政策，将福利政策直达市民，打

通政府与市民之间的最后一公里，提高主动服务和精准服务的力度。

5

DBXX/TXXXX—XXXX

B

B

附录B

（规范性）

接口调用方式和参数要求

B.1产生二维码接口

B.1.1调用方式

产生二维码接口应通过互联网或政务外网调用。

B.1.2参数要求

产生二维码接口参数要求见表B.1。

表B.1产生二维码接口参数要求

类别参数是否必填数据类型说明

输入参数accessToken是字符串用户授权后的渠道令牌

输入参数latitude是字符串纬度

输入参数longitude是字符串经度

输出参数code是字符串返回值代码

输出参数message是字符串返回情况说明

输出参数concealCard是字符串脱敏的用户身份证号码

输出参数concealName是字符串脱敏的用户姓名

输出参数qrcodeBase64是字符串二维码base64字符串

输出参数qrcodeType是字符串二维码类型

输出参数serverTime是时间服务器时间

返回数据格式统一采用字符串格式：

示例：

{

"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调用方式

用户标签信息查询接口应通过互联网或政务外网调用。

B.2.2参数要求

用户标签信息查询接口参数要求见表B.2。

表B.2用户标签信息查询接口参数要求

类别参数是否必填数据类型说明

输入参数accessToken是字符串用户授权后的渠道令牌

输出参数code是字符串返回值代码

输出参数message是字符串返回情况说明

输出参数Icon是字符串返回的填icon图片地址

输出参数no是整数标签序号

输出参数text是字符串标签的文本内容

输出参数backgroundColor是整数返回的标签底色颜色枚举值

输出参数fontColor是整数返回的字体颜色枚举值

返回数据格式统一采用字符串格式：

示例：

{

"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调用方式

渠道二维码接口应通过互联网或政务外网调用。

B.3.2参数要求

渠道二维码接口参数要求见表B.3。

表B.3渠道二维码接口参数要求

类别参数是否必填数据类型说明

输入参数accessToken是字符串用户授权后的渠道令牌

输入参数longitude是字符串经度

输入参数latitude是字符串维度

输出参数code是字符串返回值代码

输出参数message是字符串返回情况说明

输出参数qrcodeType是字符串公交码类型

输出参数qrcodeBase64是字符串二维码base64加密字符串

输出参数idCard是字符串用户身份证

输出参数serverTime是字符串请求时间

输出参数userNmae是字符串用户姓名

输出参数concelName是字符串用户脱敏姓名

输出参数concelCard是字符串用户脱敏身份证

返回数据格式统一采用字符串格式：

示例：

{

"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调用方式

解码能力接口应通过互联网或政务外网调用。

8

DBXX/TXXXX—XXXX

B.4.2参数要求

解码能力接口参数要求见表B.4。

表B.4解码能力接口参数要求

类别参数是否必填数据类型说明

输入参数merchantId是字符串商户id

输入参数time是字符串时间字符串yyyyMMssHHmmss

输入参数sign是字符串RSA签名

输入参数qrcod是字符串二维码值

输入参数macId是字符串设备编号

输出参数response是字符串AES加密的传输信息

返回数据格式统一采用字符串格式：

示例：

{

"code":"PY0000",

成功

"msg":"",

"response":

"spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgadosfjadoasfiopajsgoipasnfg

aposndapodfsjfiopasncoapsdichpsaojgdioaspjfviandsopfjaiopsndfvoiapsndvioaspnvapngvudaf

gioansvpasnfiajopdjfaisudjfpfgasjdfaiponcioapngoaphasd"

}

B.5第三方授权接口

B.5.1调用方式

第三方授权接口应通过互联网或政务外网调用。

B.5.2参数要求

第三方授权接口参数要求见表B.5。

表B.5第三方授权接口参数要求

类别参数是否必填数据类型说明

输入参数code是字符串第三方授权code

输入参数appId是字符串应用唯一标