搜索
书书书犐犆犛３５．２４０．９９犔６５中华人民共和国国家标准犌犅／犜３８９６３—２０２０个人健康信息码 应用接口犘犲狉狊狅狀犪犾犺犲犪犾狋犺犻狀犳狅狉犿犪狋犻狅狀犮狅犱犲—犃狆狆犾犻犮犪狋犻狅狀犻狀狋犲狉犳犪犮犲２０２００４２９发布２０２００４２９实施国家市场监督管理总局国家标准化管理委员会发布书书书目 次前言Ⅲ…………………………………………………………………………………………………………引言Ⅳ…………………………………………………………………………………………………………１ 范围１………………………………………………………………………………………………………２ 规范性引用文件１…………………………………………………………………………………………３ 术语和定义１………………………………………………………………………………………………４ 缩略语１……………………………………………………………………………………………………５ 接口规则１………………………………………………………………………………………………… ５．１ 接口方式１…………………………………………………………………………………………… ５．２ 服务类型１……………………………………………………………………………………………６ 接口说明２………………………………………………………………………………………………… ６．１ 概述２………………………………………………………………………………………………… ６．２ 用户健康信息申报２………………………………………………………………………………… ６．３ 用户行程申报接口３………………………………………………………………………………… ６．４ 用户健康信息查询４………………………………………………………………………………… ６．５ 健康码调用申请接口７……………………………………………………………………………… ６．６ 健康码制码请求接口８……………………………………………………………………………… ６．７ 健康码验码请求接口９……………………………………………………………………………… ６．８ 用户健康信息纠错接口１０……………………………………………………………………………７ 接口应用１１………………………………………………………………………………………………… ７．１ 应用模式１１…………………………………………………………………………………………… ７．２ 对接模式１１……………………………………………………………………………………………附录Ａ（资料性附录） 健康码ＢｉｚＥｘｔＤａｔａ字段使用说明１２……………………………………………附录Ｂ（资料性附录） 接口返回代码说明１３………………………………………………………………附录Ｃ（资料性附录） 健康码制码和验码调用示例１５……………………………………………………参考文献１６……………………………………………………………………………………………………Ⅰ犌犅／犜３８９６３—２０２０前 言 本标准是《个人健康信息码》系列标准之一，该系列标准的结构和名称如下：———ＧＢ／Ｔ３８９６１—２０２０ 个人健康信息码 参考模型；———ＧＢ／Ｔ３８９６２—２０２０ 个人健康信息码 数据格式；———ＧＢ／Ｔ３８９６３—２０２０ 个人健康信息码 应用接口。本标准按照ＧＢ／Ｔ１．１—２００９给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由国务院办公厅电子政务办公室提出。本标准由全国信息技术标准化技术委员会（ＳＡＣ／ＴＣ２８）归口。本标准起草单位：国务院办公厅电子政务办公室、中国电子技术标准化研究院、公安部第一研究所、浙江省大数据发展管理局、广东省政务服务数据管理局、上海市大数据中心、河北省政务服务中心、河南省大数据管理局、贵州省人民政府办公厅、南京市政务服务管理办公室、衢州市营商环境建设办公室、浙江省标准化研究院、杭州市数据资源管理局、合肥市数据资源局、中国科学院软件研究所、福建正孚软件有限公司、北京中盾安信科技发展有限公司、大汉软件股份有限公司、深圳市腾讯计算机系统有限公司、支付宝（中国）网络技术有限公司、北京百度网讯科技有限公司、中国电子科技集团有限公司、阿里巴巴（中国）有限公司、腾讯云计算（北京）有限责任公司、电科云（北京）科技有限公司。本标准主要起草人：卢向东、尹智刚、孙富安、李恒训、赵波、孙文龙、杨庄媛、周平、于锐、杨林、国伟、王齐春、陈治佳、杨强、陈亚军、于浩、姜舟、徐云、李景曦、王!萃、李松渊、马晓镌、张晓东、温?、张红振、林文昊、钱学文、姜淑娟、李宁、孙茂阳、齐同军、黄颖纯、聂楚江、赵立、江万鑫、王剑冰、黄炜耀、金震宇、房迎、罗朝亮、杨鹏、李昊龙、林冠辰、仲里、王舒墨、陈磊、陈昊、侯海实、陈丽平、王永霞、滕一帆、王鹏达、焦秀珍。Ⅲ犌犅／犜３８９６３—２０２０引 言 在预防、控制和消除突发公共卫生事件（例如新型冠状病毒感染的肺炎ＣＯＶＩＤ１９）危害的过程中，需要采集、存储和处理个人健康信息，以实现多种管理用途，主要包括：———快速获取个人健康的相关信息；———统计某种流行病或疾病的相关信息；———管理不同地域之间的人员流动；———互认健康信息业务等级。２０２０年２月以来，在ＣＯＶＩＤ１９疫情防控和复工复产过程中，全国一体化在线政务服务平台（简称“一体化平台”）提供的防疫健康信息码、部分省（区、市）建设使用的“健康码”，作为个人健康信息码的一种重要形式，成为快速采集、存储和处理个人健康信息的一种有效方式。个人健康信息码在实际应用过程中，存在码制组成和数据格式不一致、数据不共享和互认机制缺乏等问题，给人员跨地区流动带来了不便。因此，从当前的实践情况和长远的应用需求来看，需要实现个人健康信息码的标准一致。除突发公共卫生事件的应急处置外，个人健康信息码在个人医疗、健康养老或其他重大公众活动管理过程中同样适用。本标准中规定的具体事项，法律法规（如《中华人民共和国网络安全法》《中华人民共和国传染病防治法》）另有规定的，需遵照其规定执行。Ⅳ犌犅／犜３８９６３—２０２０个人健康信息码 应用接口１ 范围本标准规定了个人健康服务接口的接口规则、接口说明和接口应用。本标准适用于个人健康信息相关应用系统的设计、开发和系统集成。２ 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ＧＢ／Ｔ２２６０ 中华人民共和国行政区划代码ＧＢ／Ｔ３８９６１—２０２０ 个人健康信息码 参考模型３ 术语和定义ＧＢ／Ｔ３８９６１—２０２０界定的术语和定义适用于本文件。４ 缩略语 下列缩略语适用于本文件。ＨＴＴＰ：超文本传输协议（ＨｙｐｅｒＴｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏｌ）ＪＳＯＮ：轻量级的数据交换格式（ＪａｖａＳｃｒｉｐｔＯｂｊｅｃｔＮｏｔａｔｉｏｎ）ＲＥＳＴ：表述性状态转移（ＲｅｐｒｅｓｅｎｔａｔｉｏｎａｌＳｔａｔｅＴｒａｎｓｆｅｒ）Ｗｅｂ：全球广域网（ＷｏｒｌｄＷｉｄｅＷｅｂ）５ 接口规则５．１ 接口方式个人健康信息服务系统对外发布服务和接受请求应采用符合ＲＥＳＴ架构原则的Ｗｅｂ服务。５．２ 服务类型健康码相关的服务类型说明见表１。表１ 服务类型说明序号服务类型服务名称１１０００健康码调用申请接口２２０００健康码制码接口３３０００健康码验码接口１犌犅／犜３８９６３—２０２０ 健康码制码接口中的验证模式说明见表２。表２ 制码接口中的验证模式说明序号代码模式名称１Ｇ１００居民身份网络标识制码２Ｇ０１０网证数据制码 健康码验码接口中的验证模式说明见表３。表３ 验码接口中的验证模式说明序号代码模式名称１Ｖ０００业务验码２Ｖ０３３身份＋业务验码３Ｖ０３４身份＋人像＋业务验码６ 接口说明６．１ 概述接口类型及说明见表４。表４ 接口类型及说明序号接口类型接口说明１用户健康信息申报接口上传用户申报的健康数据信息２用户行程申报接口上传用户在规定的时间范围（例如１４天）内行程的数据信息３用户健康信息查询接口查询用户在一定时间段内的个人健康信息和行程信息，默认查询时段为相关部门规定的时长（例如１４天）４健康码调用申请接口客户端向服务端发起业务申请（例如制码、验码等）前需通过该接口申请会话权限５健康码制码请求接口向健康码应用系统后台发送制码请求６健康码验码请求接口向健康码应用系统后台发送验码请求７用户健康信息纠错接口向健康码应用系统后台发送纠正相关信息的请求６．２ 用户健康信息申报６．２．１ 调用方式用户健康信息申报接口应通过互联网或政务外网调用。２犌犅／犜３８９６３—２０２０６．２．２ 参数要求用户健康信息申报接口参数要求见表５。表５ 用户健康信息申报接口参数要求类别参数是否必填数据类型说明输入参数ＡｃｃｏｕｎｔＩｄ是字符串授权账号ＡｃｃｅｓｓＴｏｋｅｎ是字符串授权令牌ＢｉｚＥｘｔＤａｔａ是字符串按ＧＢ／Ｔ３８９６１—２０２０中４．２确定的形式拼接，并用密钥加密后的值，参见附录ＡＰｈｏｎｅ否字符串联系电话（可填写直系亲属电话号码）Ｄａｔｅ是字符串申报时间，时间格式为ＹＹＹＹＭＭＤＤＨＨ：ＭＭ：ＳＳＣｉｔｙ是字符串当前所在的城市（州、盟等）Ａｒｅａ是字符串所在的具体地址，例如：社区的名称Ｘｚｑｈｄｍ是字符串当前所在的县级行政区划代码，应符合ＧＢ／Ｔ２２６０规定ＩｓＥｐｉｄｅｍｉｃＡｒｅａＲｉｓｋ是字符串在卫生健康主管部门规定的时间范围内是否曾经在高风险地区居住或在高风险地区停留，１．是／２．否ＩｓＰａｔｉｅｎｔＣｏｎｔａｃｔＲｉｓｋ是字符串在卫生健康主管部门规定的时间范围内是否接触过高风险人员（确诊或疑似病例），１．是／２．否／３．不确定Ｓｙｍｐｔｏｍ是字符串当前症状（多选），多项症状用“＾”分隔Ｔｅｍｐｅｒａｔｕｒｅ是字符串体温，应填写数字。单位为摄氏度（℃）输出参数ｈｅａｄ．ｍｅｓｓａｇｅ是字符串返回情况说明ｈｅａｄ．ｓｔａｔｕｓ是字符串返回值代码，其取值及含义参见附录Ｂ 返回数据格式统一采用字符串格式。 示例：｛＂ｈｅａｄ＂：｛ ＂ｍｅｓｓａｇｅ＂：＂接口调用成功＂， ＂ｓｔａｔｕｓ＂：＂０＂｝｝６．３ 用户行程申报接口６．３．１ 调用方式用户行程申报接口应通过互联网或政务外网调用。３犌犅／犜３８９６３—２０２０６．３．２ 参数要求用户行程申报接口参数要求见表６。表６ 用户行程申报接口参数要求类别参数是否必填数据类型说明输入参数ＡｃｃｏｕｎｔＩｄ是字符串授权账号ＡｃｃｅｓｓＴｏｋｅｎ是字符串授权令牌ＢｉｚＥｘｔＤａｔａ是字符串按ＧＢ／Ｔ３８９６１—２０２０中４．２确定的形式拼接，并用密钥加密后的值，参见附录ＡＰｈｏｎｅ否字符串联系电话（可填写直系亲属电话号码）ＳｔｏｐｏｖｅｒＣｉｔｙ是字符串在卫生健康主管部门规定的时间范围内停留过的地方（精确到地市级）的市级行政区划代码，在多地市停留时用英文逗号分隔，例如：３３０１００，３３０２００ＳｔｏｐｏｖｅｒＣｉｔｙＮａｍｅ是字符串在卫生健康主管部门规定的时间范围内停留过的地方（精确到地市级）的行政区划名称，多个时用英文逗号分隔，例如：“××市，××市”ＳｔｏｐｏｖｅｒＣｏｕｎｔｙ否字符串在卫生健康主管部门规定的时间范围内停留过的地址（细化后的县级）的代码，应使用ＧＢ／Ｔ２２６０规定的县级行政区划代码，用英文逗号分隔，例如：３３０１０２，３３０２０６ＳｔｏｐｏｖｅｒＣｏｕｎｔｙＮａｍｅ否字符串在卫生健康主管部门规定的时间范围内停留过的地址（细化后的县级）的名称，应使用行政区划名称，多个时用英文逗号分隔，例如：“××市××区，××市××区”Ｄａｔｅ是字符串申报行程的时间，时间格式为ＹＹＹＹＭＭＤＤＨＨ：ＭＭ：ＳＳＰａｔｈＳｔａｔｕｓ否字符串行程的校验状态，０：未校验，１：校验成功，２：校验失败输出参数ｈｅａｄ．ｍｅｓｓａｇｅ是字符串返回消息ｈｅａｄ．ｓｔａｔｕｓ是字