GB/T 38963-2020 个人健康信息码 应用接口

　　ICS 35 . 240 . 99 L 65

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 38963—2020

　　个人健康信息码 应用接口

　　personalhealthinformationcode—Applicationinterface

　　2020-04-29 发布 2020-04-29 实施

　　国家市场监督管理总局国家标准化管理委员会

　　发

　　布

　　GB/T 38963—2020

　　GB/T 38963—2020

　　前 言

　　本标准是《个人健康信息码》系列标准之一，该系列标准的结构和名称如下：

　　—GB/T 38961—2020 个人健康信息码 参考模型;

　　—GB/T 38962—2020 个人健康信息码 数据格式;

　　—GB/T 38963—2020 个人健康信息码 应用接口 。

　　本标准按照 GB/T 1 . 1—2009 给出的规则起草。

　　请注意本文件的某些内容可能涉及专利。 本文件的发布机构不承担识别这些专利的责任。

　　本标准由国务院办公厅电子政务办公室提出。

　　本标准由全国信息技术标准化技术委员会(SAC/TC 28)归口 。

　　本标准起草单位：国务院办公厅电子政务办公室、中国电子技术标准化研究院、公安部第一研究所、浙江省大数据发展管理局、广东省政务服务数据管理局、上海市大数据中心、河北省政务服务中心、河南省大数据管理局、贵州省人民政府办公厅、南京市政务服务管理办公室、衢州市营商环境建设办公室、浙江省标准化研究院、杭州市数据资源管理局、合肥市数据资源局、中国科学院软件研究所、福建正孚软件有限公司、北京中盾安信科技发展有限公司、大汉软件股份有限公司、深圳市腾讯计算机系统有限公司、支付宝(中国)网络技术有限公司、北京百度网讯科技有限公司、中国电子科技集团有限公司、阿里巴巴(中国)有限公司、腾讯云计算(北京)有限责任公司、电科云(北京)科技有限公司。

　　本标准主要起草人：卢向东、尹智刚、孙富安、李恒训、赵波、孙文龙、杨庄媛、周平、于锐、杨林、国伟、王齐春、陈治佳、杨强、陈亚军、于浩、姜舟、徐云、李景曦、王赞萃、李松渊、马晓镌、张晓东、温喆、张红振、林文昊、钱学文、姜淑娟、李宁、孙茂阳、齐同军、黄颖纯、聂楚江、赵立、江万鑫、王剑冰、黄炜耀、金震宇、房迎、罗朝亮、杨鹏、李昊龙、林冠辰、仲里、王舒墨、陈磊、陈昊、侯海实、陈丽平、王永霞、滕一帆、王鹏达、焦秀珍。

　　GB/T 38963—2020

　　引

　　言

　　在预防、控制和消除突发公共卫生事件(例如新型冠状病毒感染的肺炎 COVID-19)危害的过程中，需要采集、存储和处理个人健康信息，以实现多种管理用途，主要包括：

　　— 快速获取个人健康的相关信息;

　　— 统计某种流行病或疾病的相关信息;

　　— 管理不同地域之间的人员流动;

　　— 互认健康信息业务等级。

　　2020 年 2 月 以来，在 COVID-19 疫情防控和复工复产过程中，全国一体化在线政务服务平台(简称“一体化平台”)提供的防疫健康信息码、部分省(区、市)建设使用的“健康码”，作为个人健康信息码的一种重要形式，成为快速采集、存储和处理个人健康信息的一种有效方式。 个人健康信息码在实际应用过程中，存在码制组成和数据格式不一致、数据不共享和互认机制缺乏等问题，给人员跨地区流动带来了不便。 因此，从当前的实践情况和长远的应用需求来看，需要实现个人健康信息码的标准一致。 除突发公共卫生事件的应急处置外，个人健康信息码在个人医疗、健康养老或其他重大公众活动管理过程中同样适用。

　　本标准中规定的具体事项，法律法规(如《中华人民共和国网络安全法》《中华人民共和国传染病防治法》)另有规定的，需遵照其规定执行。

　　GB/T 38963—2020

　　个人健康信息码 应用接口

　　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 服务类型说明

　　GB/T 38963—2020

　　健康码制码接口 中的验证模式说明见表 2 。

　　表 2 制码接口中的验证模式说明

　　健康码验码接口 中的验证模式说明见表 3 。

　　表 3 验码接口中的验证模式说明

　　6 接口说明

　　6 . 1 概述

　　接口类型及说明见表 4 。

　　表 4 接口类型及说明

　　6 . 2 用户健康信息申报

　　6 . 2 . 1 调用方式

　　用户健康信息申报接口应通过互联网或政务外网调用。

　　GB/T 38963—2020

　　6 . 2 . 2 参数要求

　　用户健康信息申报接口参数要求见表 5 。

　　表 5 用户健康信息申报接口参数要求

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

　　6 . 3 用户行程申报接口

　　6 . 3 . 1 调用方式

　　用户行程申报接口应通过互联网或政务外网调用。

　　GB/T 38963—2020

　　6 . 3 . 2 参数要求

　　用户行程申报接口参数要求见表 6 。

　　表 6 用户行程申报接口参数要求

　　6 . 4 用户健康信息查询

　　6 . 4 . 1 调用方式

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

　　6 . 4 . 2 参数要求

　　用户健康信息查询接口的参数要求见表 7 。

　　GB/T 38963—2020

　　表 7 用户健康信息查询接口参数要求

　　返回值见示例 1、示例 2 。示例 1 :

　　GB/T 38963—2020

　　示例 2 :

　　GB/T 38963—2020

　　6 . 5 健康码调用申请接口

　　6 . 5 . 1 调用方式

　　客户端向服务端发起业务申请，作为后续操作的凭证，应通过互联网或政务外网调用。

　　6 . 5 . 2 参数要求

　　健康码调用申请接口参数要求见表 8 。

　　表 8 健康码调用申请接口参数要求

　　GB/T 38963—2020

　　返回数据格式统一采用 JSON 格式。

　　示例：

　　健康码调用申请、健康码制码请求、健康码验码请求的接口调用示例参见附录 C。

　　6 . 6 健康码制码请求接口

　　6 . 6 . 1 调用方式

　　健康码制码请求接口应通过互联网或政务外网调用。

　　6 . 6 . 2 参数要求

　　健康码制码请求接口参数要求见表 9 。

　　表 9 健康码制码请求接口参数要求

　　GB/T 38963—2020

　　返回数据格式统一采用 JSON 格式。

　　示例：

　　6 . 7 健康码验码请求接口

　　6 . 7 . 1 调用方式

　　健康码验码请求接口应通过互联网或政务外网调用。

　　6 . 7 . 2 参数要求

　　健康码验码请求接口的参数要求见表 10 。

　　表 10 健康码验码请求接口参数要求

　　GB/T 38963—2020

　　返回数据格式统一采用 JSON 格式。

　　示例：

　　6 . 8 用户健康信息纠错接口

　　6 . 8 . 1 调用方式

　　针对健康信息查询页面中的错误信息，用户可发起纠错申请。用户健康信息纠错接口应通过互联网或政务外网调用。

　　6 . 8 . 2 接口参数要求

　　用户健康信息纠错接口的参数要求见表 11 。

　　表 1 1 用户健康信息纠错服务参数要求

　　GB/T 38963—2020

　　返回数据格式统一采用 JSON 格式。

　　示例：

　　7 接口应用

　　7 . 1 应用模式

　　具体防疫业务管理由各地区负责，一体化平台健康码服务主要为地方应用服务，提供综合的大数据分析比对支撑，为各地区提供健康码标准和相关数据查询接口服务。

　　各地区可在一体化平台返回的个人防疫风险提示信息基础上，结合本地区数据资源开发健康码服务，在本地区平台上直接面向组织和个人服务。

　　各地区自行决定风险等级和如何使用风险等级信息(例如企事业复工复产、社区网格化管理、各地通行等)。

　　各地区应负责所辖地的健康码服务的投诉处理。

　　7 . 2 对接模式

　　已建设健康码相关应用的地区，可按照本标准与一体化平台对接。 各地区应用软件应能识别由 一体化平台生成的健康码，实现基于一体化平台健康码的互联互通。 一体化平台提供跨地区的个人健康信息查询服务。 各地区可在此基础上，结合本地区个人健康信息数据，进行风险等级划分和评估。

　　尚未建设健康码的地区，可直接将一体化平台健康码作为本地区健康码使用。 各地区应结合本地区数据资源、疫情防控与复工复产要求和卫生健康部门的指导意见，确定管辖范围内人员的风险等级。

　　GB/T 38963—2020

　　附 录 A

　　(资料性附录)

　　健康码 BizExtData字段使用说明

　　健康码中用户信息以“姓名|身份证件号码|号码类型|国籍代号^授权时间”的格式组成，用公钥加密取得加密串后，填到“BizExtData”字段，并发送制码请求。

　　示例：

　　应用软件扫码验证通过取得“BizExtData”并作为参数调用人员信息查询接口。

　　GB/T 38963—2020

　　附 录 B

　　(资料性附录)

　　接口返回代码说明

　　用户健康信息申报、用户行程申报、用户健康信息查询及用户健康信息纠错等接 口 的返回值见表 B. 1 。

　　表 B.1 用户健康信息及行程相关接口返回值

　　健康码调用申请、健康码制码请求、健康码验码请求等接口的返回值见表 B. 2 。

　　表 B.2 二维条码接口返回值

　　GB/T 38963—2020

　　表 B.2(续)

　　GB/T 38963—2020

　　附 录 C

　　(资料性附录)

　　健康码制码和验码调用示例

　　健康码调用申请、制码和验码相关代码见示例。

　　示例：

　　GB/T 38963—2020

　　参 考 文 献

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