标准编号:	GB/T 38963-2020
中文名称:	个人健康信息码 应用接口
英文名称:	Personal health information code-Application interface
中标分类:	L65    系统设备接口
行业分类:	GB    国家标准
ICS分类:	35.240.99 35.240.99    信息技术在其他领域中的应 35.240.99
发布机构:	国家市场监督管理总局 国家标准化管理委员会
发布日期:	2020-04-29
实施日期:	2020-4-29
标准状态:	现行
翻译语言:	英文
文件格式:	PDF
中文字符数:	21000 字
翻译价格(元):	1470.00 元
交付时间:	付款后 1 个工作日

ICS 35.240.99

L 65

National Standard of the People’s Republic of China

GB/T 38963-2020

Personal health information code — Application interface

个人健康信息码 个人健康信息码 应用接口 应用接口

(English Translation)

Issue date: 2020-04-29 Implementation date: 2020-04-29

Issued by the State Administration for Market Regulation

the Standardization Administration of the People's Republic of China

Contents

Foreword ................................ ................................ ................................ ............................... i

Introduction ................................ ................................ ................................ .......................... ii

1 Scope ................................ ................................ ................................ ............................. 1

2 Normative references ................................ ................................ ................................ ..... 1

3 Terms and definitions ................................ ................................ ................................ ..... 1

4 Abbreviations................................ ................................ ................................ .................. 1

5 Interface rules ................................ ................................ ................................ ................ 1

5.1 Interface mode ................................ ................................ ................................ ..... 1

5.2 Service type ................................ ................................ ................................ ......... 2

6 Interface description ................................ ................................ ................................ ....... 2

6.1 General ................................ ................................ ................................ ................ 2

6.2 Declaration of user health information ................................ ................................ . 3

6.3 User travel declaration interface ................................ ................................ .......... 5

6.4 User health information query ................................ ................................ ............. 6

6.5 Health code calling request interface ................................ ................................ .. 9

6.6 Query interface for generating health code ................................ ....................... 11

6.7 Query interface for verifying health code ................................ ........................... 12

6.8 Error correction interface of user health information ................................ ......... 14

7 Interface application ................................ ................................ ................................ ..... 15

7.1 Application Modes ................................ ................................ ............................. 16

7.2 Linking mode ................................ ................................ ................................ ...... 16

Annex A (informative) Operation instructions of BizExtData field in health code ........... 17

Annex B (informative) Description of interface return code ................................ ............ 18

Annex C (informative) Example of calling of health code generation and verification ... 20

Bibliography ................................ ................................ ................................ ....................... 21

i

ii

Introduction

In the process of preventing, controlling and eliminating the hazards of public health emergencies (such as pneumonia COVID-19 caused by novel coronavirus), it is necessary to collect, store and process personal health information for various management purposes, including:

—— Quickly obtain relevant information about personal health;

—— Collect relevant information about an epidemic or disease;

—— Manage personnel flow between different regions;

—— Mutual recognition of health information business level.

Since February 2020, in the process of prevention and control of COVID-19 epidemic and resumption of production, the epidemic prevention health information code provided by the National Integrated Online Government Service Platform (referred to as "integrated platform") and the "health code" used by some provinces (autonomous regions and municipalities) have become an important form of personal health information code, and become an effective way to quickly collect, store and process personal health information. In the practical application of personal health information codes, there are problems such as inconsistent code composition and data format, non-sharing of data and lack of mutual recognition mechanism, which bring inconveniences to the movement of people across regions. Therefore, from the current practice situation and long-term application needs, it is necessary to achieve consistent standards for personal health information codes. In addition to emergency response to public health emergencies, personal health information codes are equally applicable in the process of managing personal medical care, health care or other major public events.

For the specific matters specified in this standard, if there are other provisions in laws and regulations (such as Cybersecurity Law of the People's Republic of China and Law of the People's Republic of China on Prevention and Treatment of Infectious Diseases), these provisions shall be followed.

1

Personal health information code — Application interface

1 Scope

This standard specifies the interface rules, interface descriptions and interface applications of personal health service interfaces.

This standard is applicable to the design, development and system integration of personal health information related application systems.

2 Normative references

The following referenced documents are indispensable for the application of this standard. For dated reference, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

GB/T 2260

Codes for the administrative divisions of the People’s Republic of China

GB/T 38961-2020

Personal health information code — Reference model

3 Terms and definitions

For the purposes of this document, the terms and definitions given in GB/T 38961-2020 apply.

4 Abbreviations

For the purposes of this document, the following abbreviations apply.

HTTP: HyperText Transfer Protocol

JSON: JavaScript Object Notation

REST: Representational State Transfer

WEB: World Wide Web

5 Interface rules

5.1 Interface mode

2

The personal health information service system shall adopt the Web service conforming to the REST architecture principle when publishing services and receiving requests.

5.2 Service type

See Table 1 for description of service types related to health codes.

Table 1 Description of service type

No.

Service type

Service name

1

1000

Health code calling request interface

2

2000

Health code generation interface

3

3000

Health code verification interface

See Table 2 for the description of the verification mode in the health code generation interface.

Table 2 Description for the verification mode in the health code generation interface

No.

Code

Mode name

1

G100

Code generation of residential identity network identifier

2

G010

Code generation of web certificate data

See Table 3 for the description of the verification mode in the health code verification interface.

Table 3 Description of the verification mode in the verification interface

No.

Code

Mode name

1

V000

Business verification code

2

V033

Identity + business verification code

3

V034

Identity + portrait + business verification code

6 Interface description

6.1 General

See Table 4 for the interface types and descriptions.

3

Table 4 Interface types and descriptions

No.

Interface type

Interface description

1

User health information declaration interface

Upload health data information declared by users

2

User travel information declaration interface

Upload the data information of the user's travel within the specified time range (for example, 14 days)

3

User health information query interface

Query the personal health information and travel information of the user within a certain period of time. The default query period is the time specified by relevant departments (for example, 14 days)

4

Health code calling request interface

Before the client initiates a business application (such as code generation and code for verification, etc.) to the server, it needs to apply for session permission through this interface

5

Query interface for generating health code

Send code generation request to the background of the health code application system

6

Query interface for verifying health code

Send code verification request to the background of the health code application system

7

Error correction interface of user health information

Send a request for correcting relevant information to the background of the health code application system

6.2 Declaration of user health information

6.2.1 Calling mode

The user health information declaration interface shall be called through the Internet or the National E-Government Network.

6.2.2 Parameter requirements

See Table 5 for parameter requirements of user health information declaration interface.

Table 5 Parameter requirements of user health information declaration interface

Category

Parameter

Required or not

Data

Type

Description

Input parameter

AccountId

Yes

Character string

Authorized account

AccessToken

Yes

Character string

Access token

BizExtData

Yes

Character string

See Annex A for the values spliced according to the form determined in 4.2 of GB/T 38961-2020 and encrypted by key

Phone

No

Character string

Contact number (telephone number of direct relatives may be filled in)

21

Bibliography

[1] GB/T 38962-2020 Personal health information code — Data format

___________________________________________________ __________________________________ _________________ __________________________________ _________________ __________________________________

Foreword i
Introduction ii
1 Scope
2 Normative references
3 Terms and definitions
4 Abbreviations
5 Interface rules
5.1 Interface mode
5.2 Service type
6 Interface description
6.1 General
6.2 Declaration of user health information
6.3 User travel declaration interface
6.4 User health information query
6.5 Health code calling request interface
6.6 Query interface for generating health code
6.7 Query interface for verifying health code
6.8 Error correction interface of user health information
7 Interface application
7.1 Application Modes
7.2 Linking mode
Annex A (informative) Operation instructions of BizExtData field in health code
Annex B (informative) Description of interface return code
Annex C (informative) Example of calling of health code generation and verification
Bibliography

ICS 35.240.99
L 65
中华人民共和国国家标准
GB/T 38963—2020
个人健康信息码 应用接口
Personal health information code—Application interface
2020-04-29发布 2020-04-29实施
国家市场监督管理总局
国家标准化管理委员会 发布
前 言
本标准是《个人健康信息码》系列标准之一，该系列标准的结构和名称如下：
——GB/T 38961—2020 个人健康信息码 参考模型；
——GB/T 38962—2020 个人健康信息码 数据格式；
——GB/T 38963—2020 个人健康信息码 应用接口。
本标准按照GB/T 1.1—2009给出的规则起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。
本标准由国务院办公厅电子政务办公室提出。
本标准由全国信息技术标准化技术委员会(SAC/TC28)归口。
引 言
在预防、控制和消除突发公共卫生事件(例如新型冠状病毒感染的肺炎COVID-19)危害的过程中，需要采集、存储和处理个人健康信息，以实现多种管理用途，主要包括：
——快速获取个人健康的相关信息；
——统计某种流行病或疾病的相关信息；
——管理不同地域之间的人员流动；
——互认健康信息业务等级。
2020年2月以来，在COVID-19疫情防控和复工复产过程中，全国一体化在线政务服务平台(简称“一体化平台”)提供的防疫健康信息码、部分省(区、市)建设使用的“健康码”，作为个人健康信息码的一种重要形式，成为快速采集、存储和处理个人健康信息的一种有效方式。个人健康信息码在实际应用过程中，存在码制组成和数据格式不一致、数据不共享和互认机制缺乏等问题，给人员跨地区流动带来了不便。因此，从当前的实践情况和长远的应用需求来看，需要实现个人健康信息码的标准一致。除突发公共卫生事件的应急处置外，个人健康信息码在个人医疗、健康养老或其他重大公众活动管理过程中同样适用。
本标准中规定的具体事项，法律法规(如《中华人民共和国网络安全法》《中华人民共和国传染病防治法》)另有规定的，需遵照其规定执行。
个人健康信息码 应用接口
1 范围
本标准规定了个人健康服务接口的接口规则、接口说明和接口应用。
本标准适用于个人健康信息相关应用系统的设计、开发和系统集成。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
GB/T 2260 中华人民共和国行政区划代码
GB/T 38961—2020 个人健康信息码 参考模型
3 术语和定义
GB/T 38961—2020界定的术语和定义适用于本文件。
4 缩略语
下列缩略语适用于本文件。
HTTP：超文本传输协议(HyperText Transfer Protocol)
JSON：轻量级的数据交换格式(JavaScript Object Notation)
REST：表述性状态转移(Representational State Transfer)
Web：全球广域网(World Wide Web)
5 接口规则
5.1 接口方式
个人健康信息服务系统对外发布服务和接受请求应采用符合REST 架构原则的Web服务。
5.2 服务类型
健康码相关的服务类型说明见表1。
表1 服务类型说明
序号 服务类型 服务名称
1 1000 健康码调用申请接口
2 2000 健康码制码接口
3 3000 健康码验码接口
健康码制码接口中的验证模式说明见表2。
表2 制码接口中的验证模式说明
序号 代码 模式名称
1 G100 居民身份网络标识制码
2 G010 网证数据制码
健康码验码接口中的验证模式说明见表3。
表3 验码接口中的验证模式说明
序号 代码 模式名称
1 V000 业务验码
2 V033 身份+业务验码
3 V034 身份+人像+业务验码
6 接口说明
6.1 概述
接口类型及说明见表4。
表4 接口类型及说明
序号 接口类型 接口说明
1 用户健康信息申报接口 上传用户申报的健康数据信息
2 用户行程申报接口 上传用户在规定的时间范围(例如14天)内行程的数据信息
3 用户健康信息查询接口 查询用户在一定时间段内的个人健康信息和行程信息，默认查询时段为相关部门规定的时长(例如14天)
4 健康码调用申请接口 客户端向服务端发起业务申请(例如制码、验码等)前需通过该接口申请会话权限
5 健康码制码请求接口 向健康码应用系统后台发送制码请求
6 健康码验码请求接口 向健康码应用系统后台发送验码请求
7 用户健康信息纠错接口 向健康码应用系统后台发送纠正相关信息的请求
6.2 用户健康信息申报
6.2.1 调用方式
用户健康信息申报接口应通过互联网或政务外网调用。
6.2.2 参数要求
用户健康信息申报接口参数要求见表5。
表5 用户健康信息申报接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入参数 AccountId 是 字符串 授权账号
AccessToken 是 字符串 授权令牌
BizExtData 是 字符串 按GB/T 38961—2020中4.2确定的形式拼接，并用密钥加密后的值，参见附录A
Phone 否 字符串 联系电话(可填写直系亲属电话号码)
Date 是 字符串 申报时间，时间格式为YYYY-MM-DD HH：MM：SS
City 是 字符串 当前所在的城市(州、盟等)
Area 是 字符串 所在的具体地址，例如：社区的名称
Xzqhdm 是 字符串 当前所在的县级行政区划代码，应符合GB/T 2260规定
IsEpidemicAreaRisk 是 字符串 在卫生健康主管部门规定的时间范围内是否曾经在高风险地区居住或在高风险地区停留，1.是/2.否
IsPatientContactRisk 是 字符串 在卫生健康主管部门规定的时间范围内是否接触过高风险人员(确诊或疑似病例)，1.是/2.否/3.不确定
Symptom 是 字符串 当前症状(多选)，多项症状用“^”分隔
Temperature 是 字符串 体温，应填写数字。单位为摄氏度(℃)
输出
参数 head.message 是 字符串 返回情况说明
head.status 是 字符串 返回值代码，其取值及含义参见附录B
返回数据格式统一采用字符串格式。
示例：

＂message＂:＂接口调用成功＂,

6.3 用户行程申报接口
6.3.1 调用方式
用户行程申报接口应通过互联网或政务外网调用。
6.3.2 参数要求
用户行程申报接口参数要求见表6。
表6 用户行程申报接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入参数 AccountId 是 字符串 授权账号
AccessToken 是 字符串 授权令牌
BizExtData 是 字符串 按GB/T 38961—2020中4.2确定的形式拼接，并用密钥加密后的值，参见附录A
Phone 否 字符串 联系电话(可填写直系亲属电话号码)
StopoverCity 是 字符串 在卫生健康主管部门规定的时间范围内停留过的地方(精确到地市级)的市级行政区划代码，在多地市停留时用英文逗号分隔，例如：330100，330200
StopoverCityName 是 字符串 在卫生健康主管部门规定的时间范围内停留过的地方(精确到地市级)的行政区划名称，多个时用英文逗号分隔，例如：“××市，××市”
StopoverCounty 否 字符串 在卫生健康主管部门规定的时间范围内停留过的地址(细化后的县级)的代码，应使用GB/T 2260 规定的县级行政区划代码，用英文逗号分隔，例如：330102，330206
StopoverCountyName 否 字符串 在卫生健康主管部门规定的时间范围内停留过的地址(细化后的县级)的名称，应使用行政区划名称，多个时用英文逗号分隔，例如：“××市××区，××市××区”
Date 是 字符串 申报行程的时间，时间格式为YYYY-MM-DD HH：MM：SS
PathStatus 否 字符串 行程的校验状态，0：未校验，1：校验成功，2：校验失败
输出参数 head.message 是 字符串 返回消息
head.status 是 字符串 返回码，其取值及含义参见附录B
6.4 用户健康信息查询
6.4.1 调用方式
用户健康信息查询接口应通过互联网或政务外网调用。
6.4.2 参数要求
用户健康信息查询接口的参数要求见表7。
表7 用户健康信息查询接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入
参数 AccountId 是 字符串 授权账号
AccessToken 是 字符串 授权令牌
BizExtData 是 字符串 按GB/T 38961—2020中4.2确定的形式拼接，并用密钥加密后的值，参见附录A
StartDate 否 字符串 查询起始时间，在卫生健康主管部门规定的时间范围内取值，格式为YYYY-MM-DD HH：MM：SS
以14天为例，2020-02-16 08：30：00 查询，则StartDate可取2020-02-02 08：30：00至2020-02-16 08：30：00的任意时间
EndDate 否 字符串 查询截止时间，在卫生健康主管部门规定的时间范围内取值，不早于StartDate，格式为YYYY-MM-DD HH：MM：SS
BizType 否 字符串 业务类型
输出
参数 head.message 是 字符串 返回消息
head.status 是 字符串 返回码，其取值及含义参见附录B
person 是 JSON 用户身份的脱敏信息
yqReports 否 JSON 用户申报的健康信息
yqWarn 是 JSON 健康风险信息
healthyReport 否 JSON 从各地区汇集的健康证明信息目录数据
xcgj 否 JSON 卫生健康主管部门规定的时间范围内行程数据
返回值见示例1、示例2。
示例1：

＂message＂:＂接口调用成功＂,
＂desensitizeCardId＂:＂131************314＂,//个人身份证件号码脱敏信息
＂desensitizeName＂:＂张*＂ //姓名脱敏信息
＂warnType＂:＂确诊＂, //风险类型
＂fbrq＂:＂2020-02-10＂, //发病日期
＂qzrq＂:＂2020-02-10＂, //确诊日期
＂jcrq＂:＂2020-02-10＂, //接触日期
＂jclx＂:＂聚餐＂, //接触类型

＂mdtrtDate＂:＂2020-02-10＂, //入院时间
＂dscgDate＂:＂2020-02-20＂ //出院时间
healthyStaus＂:＂00＂, //10:红码(高风险);01:黄码(中风险);00:绿码(低风险)
＂date＂:＂2020-03-02＂, //健康风险等级评估时间(取值见GB/T 38962—2020)
＂reason＂:＂＂, //健康风险等级评估原因(取值见GB/T 38962—2020)
＂dataSource＂:＂××省＂ //来源省份
＂reason＂:＂体温超过37.3℃＂,
＂dataSource＂:＂××省＂
＂stopoverCityName＂:＂××市,××市＂,
＂stopoverCountyName＂:＂××市××区,××市××区＂,
＂fxdj＂:＂0,0＂ //风险等级,0和空:代表未查询到风险信息1:低风险2:中风险3:高风险
＂stopoverCityName＂:＂××市,××市＂,
＂stopoverCountyName＂:＂××市××区,××市××区＂,
示例2:

＂message＂:＂接口调用成功＂,

＂warnType＂:＂无＂

6.5 健康码调用申请接口
6.5.1 调用方式
客户端向服务端发起业务申请，作为后续操作的凭证，应通过互联网或政务外网调用。
6.5.2 参数要求
健康码调用申请接口参数要求见表8。
表8 健康码调用申请接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入
参数 bizPackage.orgCode 是 字符串 机构标识
bizPackage.appId 是 字符串 应用标识
bizPackage.appUserId 否 字符串 应用用户标识
bizPackage.bizType 是 字符串 业务类型
bizPackage.bizData.authMode 是 字符串 制码/验码模式
bizPackage.bizData.applyData 否 字符串 服务类型为2000，同时制码模式为G010 时必填，其值由网证认证控件接口的getApplyData方法生成
sign 是 字符串 bizPackage签名值的Base64编码串
输出
参数 bizPackage.resultCode 是 字符串 结果返回码，取值及含义参见附录B的表B.2
bizPackage.resultDesc 否 字符串 结果描述
bizPackage.bizData.bsn 是 字符串 业务流水号
bizPackage.bizData.randomNumber 是 字符串 随机数
sign 是 字符串 bizPackage签名值的Base64编码串
返回数据格式统一采用JSON 格式。
示例：

健康码调用申请、健康码制码请求、健康码验码请求的接口调用示例参见附录C。
6.6 健康码制码请求接口
6.6.1 调用方式
健康码制码请求接口应通过互联网或政务外网调用。
6.6.2 参数要求
健康码制码请求接口参数要求见表9。
表9 健康码制码请求接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入参数 bizPackage.orgCode 是 字符串 机构标识
bizPackage.appId 是 字符串 应用标识
bizPackage.appUserId 否 字符串 应用用户标识
bizPackage.bsn 是 字符串 业务流水号
bizPackage.bizType 是 字符串 业务类型
bizPackage.bizData.authMode 是 字符串 制码模式，与调用申请匹配，见表2
bizPackage.bizData.bizExtData 是 字符串 业务扩展数据，参见附录A
bizPackage.bizData.identityData 是 字符串 制码模式为G100时，值为居民身份网络标识；
制码模式为G010时，值为网证数据
sign 是 字符串 bizPackage签名值的Base64编码串
输出参数 bizPackage.resultCode 是 字符串 结果返回码，取值及含义参见附录B的表B.2
bizPackage.resultDesc 否 字符串 结果描述
bizPackage.bizData.imgStream 是 字符串 二维条码图像文件流
bizPackage.bizData.width 是 字符串 位图边长
sign 是 字符串 bizPackage签名值的Base64编码串
返回数据格式统一采用JSON 格式。
示例：

6.7 健康码验码请求接口
6.7.1 调用方式
健康码验码请求接口应通过互联网或政务外网调用。
6.7.2 参数要求
健康码验码请求接口的参数要求见表10。
表10 健康码验码请求接口参数要求
类别 参数 是否
必填 数据
类型 说明
输入参数 bizPackage.orgCode 是 字符串 机构标识
bizPackage.appId 是 字符串 应用标识
bizPackage.userId 是 字符串 用户标识
bizPackage.bizType 是 字符串 业务类型
bizPackage.bizData.authMode 是 字符串 验码模式，与调用申请匹配，见表3
bizPackage.bizData.randomNumber 是 字符串 随机数，验证模式为V033、V034时必填
bizPackage.bizData.qrCode 是 字符串 健康码字符串
bizPackage.bizData.photoData 否 字符串 根据验证模式确定，验证模式为V034时必填，取值为人像照片数据(加密)Base64编码串
sign 是 字符串 bizPackage签名值的Base64编码串
输出参数 bizPackage.resultCode 是 字符串 结果返回码，取值及含义参见附录B的表B.2
bizPackage.resultDesc 否 字符串 结果描述
bizPackage.bizData.bizExtData 是 字符串 业务扩展数据，参见附录A
bizPackage.bizData.gbMark 否 字符串 居民身份网络标识
bizPackage.bizData.appUserId 否 字符串 应用用户标识
sign 是 字符串 bizPackage签名值的Base64编码串
返回数据格式统一采用JSON 格式。
示例：

6.8 用户健康信息纠错接口
6.8.1 调用方式
针对健康信息查询页面中的错误信息，用户可发起纠错申请。
用户健康信息纠错接口应通过互联网或政务外网调用。
6.8.2 接口参数要求
用户健康信息纠错接口的参数要求见表11。
表11 用户健康信息纠错服务参数要求
类别 参数 是否
必填 数据
类型 说明
输入参数 AccountId 是 字符串 授权账号
AccessToken 是 字符串 授权令牌
BizExtData 是 字符串 按GB/T 38961—2020中4.2确定的形式拼接，并用密钥加密后的值，参见附录A
ErrorType 是 字符串 错误类型
Title 是 字符串 问题标题
Description 是 字符串 问题详细描述
Date 是 字符串 纠错反馈时间，格式 YYYY-MM-DD HH：MM：SS
City 是 字符串 当前所在城市，使用行政区划代码
Phone 是 字符串 电话号码
Remarks 否 字符串 其他说明
输出
参数 head.message 是 字符串 返回消息
head.status 是 字符串 返回码，其取值及具体含义参见附录B
返回数据格式统一采用JSON 格式。
示例：

＂message＂:＂接口调用成功＂,

7 接口应用
7.1 应用模式
具体防疫业务管理由各地区负责，一体化平台健康码服务主要为地方应用服务，提供综合的大数据分析比对支撑，为各地区提供健康码标准和相关数据查询接口服务。
各地区可在一体化平台返回的个人防疫风险提示信息基础上，结合本地区数据资源开发健康码服务，在本地区平台上直接面向组织和个人服务。
各地区自行决定风险等级和如何使用风险等级信息(例如企事业复工复产、社区网格化管理、各地通行等)。
各地区应负责所辖地的健康码服务的投诉处理。
7.2 对接模式
已建设健康码相关应用的地区，可按照本标准与一体化平台对接。各地区应用软件应能识别由一体化平台生成的健康码，实现基于一体化平台健康码的互联互通。一体化平台提供跨地区的个人健康信息查询服务。各地区可在此基础上，结合本地区个人健康信息数据，进行风险等级划分和评估。
尚未建设健康码的地区，可直接将一体化平台健康码作为本地区健康码使用。各地区应结合本地区数据资源、疫情防控与复工复产要求和卫生健康部门的指导意见，确定管辖范围内人员的风险等级。
附 录 A
(资料性附录)
健康码BizExtData字段使用说明
健康码中用户信息以“姓名|身份证件号码|号码类型|国籍代号^授权时间”的格式组成，用公钥加密取得加密串后，填到“BizExtData”字段，并发送制码请求。
示例：

// 读取公钥私钥
Stringstr= ＂张××|110101********0101|111|CHN^20200320120001＂;
System.out.println(＂明文:＂ + str);
System.out.println(＂\n公钥加密——私钥解密＂);
// 传入明文和公钥加密,得到密文
System.out.println(＂密文:＂ + encodedData);
// 传入密文和私钥,得到明文
System.out.println(＂解密后文字:＂ + decodedData);
System.out.println(＂\n私钥加密——公钥解密＂);
// 传入明文和私钥加密,得到密文
System.out.println(＂密文:＂ + encodedData);
// 传入密文和私钥,得到明文
System.out.println(＂解密后文字:＂ + decodedData);

应用软件扫码验证通过取得“BizExtData”并作为参数调用人员信息查询接口。
附 录 B
(资料性附录)
接口返回代码说明
用户健康信息申报、用户行程申报、用户健康信息查询及用户健康信息纠错等接口的返回值见表B.1。
表B.1 用户健康信息及行程相关接口返回值
返回值编码 编码描述
0 接口调用成功
1 第三方接口连接超时
2 证照源未提供此服务接口
10 未找到匹配的信息
11 身份验证不通过
12 要求必填的输入参数值为空
15 参数格式不正确
25 返回内容未找到指定数据项
99 其他异常
健康码调用申请、健康码制码请求、健康码验码请求等接口的返回值见表B.2。
表B.2 二维条码接口返回值
返回值编码 编码描述
0 成功
I120000 网关：网关内部异常、访问后台服务失败等，对应HTTP状态码：404、500、503
I120001 网关：网关层系统繁忙(过载保护)，对应HTTP状态码：503
I110000 网关：无法解析的请求、缺少关键字段，对应HTTP状态码：400
I110001 网关：身份获取失败、验签失败等，对应HTTP状态码：401
I110002 网关：应用无权限访问，对应HTTP状态码：403
I110003 网关：服务调用次数上限，对应HTTP状态码：403
B120100 申请服务：系统异常
B110101 申请服务：业务异常
B110102 申请服务：请求参数不合法
B120200 制码服务：系统异常
B110201 制码服务：业务异常
B110202 制码服务：请求参数不合法
B110203 制码服务：网证不存在
B110204 制码服务：网证已失效
B110205 制码服务：二维条码生成失败
B110206 制码服务：流水号失效
B110302 验码服务：请求参数不合法
B120300 验码服务：系统异常
B110301 验码服务：业务异常
B110303 验码服务：居民身份网络标识不一致
B110304 验码服务：无效二维条码
B110305 验码服务：流水号失效
B110306 验码服务：二维条码已失效或已过期
注：业务层返回HTTP状态码统一为200。

附 录 C
(资料性附录)
健康码制码和验码调用示例
健康码调用申请、制码和验码相关代码见示例。
示例：

//1、健康码制码调用申请
String gbMark = ＂1234567890＂; //居民身份网络标识
String bizExtData = ＂abcdefhijklmnopqrst＂; //业务扩展数据
//2、健康制码
//3、健康码验码调用申请
//4、健康码验码


参 考 文 献
[1] GB/T 38962—2020 个人健康信息码 数据格式