(高清版)GB∕T 38963-2020 个人健康信息码 应用接口

个人健康信息码应用接口2020-04-29发布2020-04-29实施国家标准化管理委员会国家市场监督管理总局发布国家标准化管理委员会IGB/T38963—2020前言 Ⅲ 1 1 1 1 15.1接口方式 15.2服务类型 1 2 2 26.3用户行程申报接口 3 46.5健康码调用申请接口 76.6健康码制码请求接口 86.7健康码验码请求接口 96.8用户健康信息纠错接口 7接口应用 7.1应用模式 7.2对接模式 附录B(资料性附录)接口返回代码说明 附录C(资料性附录)健康码制码和验码调用示例 Ⅲ ——GB/T38962—2020个人健康信息码数据格式；——GB/T38963—2020个人健康信息码应用接口。本标准由全国信息技术标准化技术委员会(SAC/引 样适用。1下列文件对于本文件的应用是必不可少的。凡是注日期的引GB/T38961—2020个人健康信息码参考模型HTTP:超文本传输协议(HyperTextTransferProtocol)JSON:轻量级的数据交换格式(JavaScriptObjectNotation)REST:表述性状态转移(RepresentationalWeb:全球广域网(WorldWideWeb)健康码相关的服务类型说明见表1。1健康码调用申请接口2健康码制码接口3健康码验码接口212网证数据制码12身份十业务验码3身份十人像十业务验码接口说明1用户健康信息申报接口上传用户申报的健康数据信息2用户行程申报接口上传用户在规定的时间范围(例如14天)内行程的数据信息3用户健康信息查询接口段为相关部门规定的时长(例如14天)4健康码调用申请接口客户端向服务端发起业务申请(例如制码、验码等)前需通过该接口申请会话权限5健康码制码请求接口向健康码应用系统后台发送制码请求6健康码验码请求接口向健康码应用系统后台发送验码请求7用户健康信息纠错接口向健康码应用系统后台发送纠正相关信息的请求3类别说明是字符串是字符串是字符串按GB/T38961—2020中4.2确定的形式否字符串联系电话(可填写直系亲属电话号码)是字符串申报时间，时间格式为YYYY-MM-DDHH:MM:SS是字符串当前所在的城市(州、盟等)是字符串是字符串当前所在的县级行政区划代码，应符合GB/T2260规定是字符串地区居住或在高风险地区停留，1.是/2.否是字符串人员(确诊或疑似病例),1.是/2.否是字符串当前症状(多选),多项症状用“~”分隔是字符串体温，应填写数字。单位为摄氏度(℃)输出是字符串返回情况说明是字符串"message":"接口调用成功",}4类别数据类型说明是字符串是字符串是字符串按GB/T38961—2020中4.2确定的形式拼接，并用密钥加否字符串联系电话(可填写直系亲属电话号码)是字符串是字符串确到地市级)的行政区划名称，多个时用英文逗号分隔，例如：“××市，×X市”否字符串化后的县级)的代码，应使用GB/T22区划代码，用英文逗号分隔，例如：330102,330206否字符串逗号分隔，例如：“×X市××区，××市××区”是字符串申报行程的时间，时间格式为YYYY-MM-DDHH:否字符串输出是字符串返回消息是字符串5类别数据类型说明是字符串是字符串是字符串按GB/T38961—2020中4.2确定的形否字符串值，格式为YYYY-MM-DDHH:MM:SS以14天为例，2020-02-1608:30:00查询，则Star2020-02-0208:30:00至2020-02-1608:30:00的任意时间否字符串值，不早于StartDate,格式为YYYY-MM-DD否字符串输出是字符串返回消息是字符串是用户身份的脱敏信息否用户申报的健康信息是健康风险信息否否示例1:{"message":"接口调用成功","desensitizeCardld":"131兴晃晃晃晃314",//个人身份证件号码脱敏信息"desensitizeName":"张"//姓名脱敏信息"warnType":"确诊",//风险类型"fbrq":"2020-02-10",//发病日期"qzrq":"2020-02-10",//确诊日期"jcrq":"2020-02-10",//接触日期"jclx":"聚餐",//接触类型6"mdtrtDate":"2020-02-10",//入院时间"dscgDate":"2020-02-20"//出院时间"healthyStaus":"00",//10:红码(高风险);01:黄码(中风险);00:绿码(低风险)"date":"2020-03-02",//健康风险等级评估时间(取值见GB/T38962—2020)"reason":"",//健康风险等级评估原因(取值见GB/T38962—2020)"dataSource":"××省"//来源省份"reason":"体温超过37.3℃""dataSource":"××省""stopoverCityName":"××市，X×市","stopoverCounty":"3"stopoverCountyName":"×X市××区，××市××区","fxdj":"0,0"//风险等级，0和空：代表未查询到风险信息1:低风险2:中风险3:高风险"stopoverCityName":"XX市，XX市","stopoverCounty":"3"stopoverCountyName":"××市××区，××市××区",}示例2:"message":"接口调用成功",7"warnType":"无"类别说明是字符串是字符串否字符串是字符串bizPData.aut是字符串bizPData.ap否字符串是字符串bizPackage签名值的Base64编码串输出是字符串结果返回码，取值及含义参见附录B的表B.2否字符串是字符串bizPData.是字符串随机数是字符串bizPackage签名值的Base64编码串8类别说明是字符串是字符串否字符串是字符串是字符串bizPData.aut是字符串bizPDEx是字符串是字符串制码模式为G100时，值为居民身份网络标识；是字符串bizPackage签名值的Base64编码串输出是字符串结果返回码，取值及含义参见附录B的表B.2否字符串bizPData,imgS是字符串bizPData.是字符串是字符串bizPackage签名值的Base64编码串类别说明是字符串是字符串是字符串是字符串bizPData.aut是字符串bizPData,randomN是字符串随机数，验证模式为V033、V034时必填bizPData.q是字符串健康码字符串bizPData.ph否字符串取值为人像照片数据(加密)Base64编码串是字符串bizPackage签名值的Base64编码串输出是字符串结果返回码，取值及含义参见附录B的表B.2否字符串bizPData,bizEx是字符串bizPData.g否字符串bizPData.appU否字符串是字符串bizPackage签名值的Base64编码串9返回数据格式统一采用JSON格式。用户健康信息纠错接口的参数要求见表11。表11用户健康信息纠错服务参数要求类别说明是字符串是字符串是字符串按GB/T38961—2020中4.2确定的形式是字符串是字符串问题标题是字符串问题详细描述是字符串纠错反馈时间，格式YYYY-MM-DDHH:MM:SS是字符串当前所在城市，使用行政区划代码是字符串电话号码否字符串其他说明输出是字符串是字符串返回数据格式统一采用JSON格式。(资料性附录)健康码BizExtData字段使用说明健康码中用户信息以“姓名|身份证件号码|号码类型|国籍代号^授权时间”的格式组成，用公钥加密取得加密串后，填到“BizExtData”字段，并发送制码请求。publicstaticvoidmathrowsNoSuchAlgorithmException,InvalidKeySpecException,CertificateExcRSAPublicKeypublicKey=RSAUtils.getPublRSAPrivateKeyprivateKey=RSAUtils.getRSSystem.out.println("明文："+str);StringencodedData=RSAUtils.pSystem.out.println("密文："+encodedData);StringdecodedData=RSAUtils.privateDecSystem.out.println("解密后文字："+decodedData);encodedData=RSAUtils.privateEncrypt(System.out.println("密文："+encodedData);decodedData=RSAUtils.publicDecrypt(encodedDatSystem.out.println("解密后文字："+decodedData);应用软件扫码验证通过取得“BizExtData”并作为参数调用人员信息查询接口。用户健康信息申报、用户行程申报、用户健康信息查询及用户健康信息纠错等接口的返回值见012证照源未提供此服务接口未找到匹配的信息参数格式不正确0网关：网关内部异常、访问后台服务失败等，对应HTTP状态码：404、500、503网关：网关层系统繁忙(过载保护),对应HTTP状态码：503网关：无法解析的请求、缺少关键字段，对应HTTP状态码：400网关：身份获取失败、验签失败等，对应HTTP状态码：401网关：应用无权限访问，对应HTTP状态码：403网关：服务调用次数上限，对应HTTP状态码：403申请服