(高清版)GB∕T 38963-2020 個人健康信息碼 應用接口

個人健康信息碼應用接口2020-04-29發(fā)布2020-04-29實施國家標準化管理委員會國家市場監(jiān)督管理總局發(fā)布國家標準化管理委員會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:表述性狀態(tài)轉移(RepresentationalWeb:全球廣域網(WorldWideWeb)健康碼相關的服務類型說明見表1。1健康碼調用申請接口2健康碼制碼接口3健康碼驗碼接口212網證數據制碼12身份十業(yè)務驗碼3身份十人像十業(yè)務驗碼接口說明1用戶健康信息申報接口上傳用戶申報的健康數據信息2用戶行程申報接口上傳用戶在規(guī)定的時間范圍(例如14天)內行程的數據信息3用戶健康信息查詢接口段為相關部門規(guī)定的時長(例如14天)4健康碼調用申請接口客戶端向服務端發(fā)起業(yè)務申請(例如制碼、驗碼等)前需通過該接口申請會話權限5健康碼制碼請求接口向健康碼應用系統(tǒng)后臺發(fā)送制碼請求6健康碼驗碼請求接口向健康碼應用系統(tǒng)后臺發(fā)送驗碼請求7用戶健康信息糾錯接口向健康碼應用系統(tǒng)后臺發(fā)送糾正相關信息的請求3類別說明是字符串是字符串是字符串按GB/T38961—2020中4.2確定的形式否字符串聯系電話(可填寫直系親屬電話號碼)是字符串申報時間，時間格式為YYYY-MM-DDHH:MM:SS是字符串當前所在的城市(州、盟等)是字符串是字符串當前所在的縣級行政區(qū)劃代碼，應符合GB/T2260規(guī)定是字符串地區(qū)居住或在高風險地區(qū)停留，1.是/2.否是字符串人員(確診或疑似病例),1.是/2.否是字符串當前癥狀(多選),多項癥狀用“~”分隔是字符串體溫，應填寫數字。單位為攝氏度(℃)輸出是字符串返回情況說明是字符串"message":"接口調用成功",}4類別數據類型說明是字符串是字符串是字符串按GB/T38961—2020中4.2確定的形式拼接，并用密鑰加否字符串聯系電話(可填寫直系親屬電話號碼)是字符串是字符串確到地市級)的行政區(qū)劃名稱，多個時用英文逗號分隔，例如：“××市，×X市”否字符串化后的縣級)的代碼，應使用GB/T22區(qū)劃代碼，用英文逗號分隔，例如：330102,330206否字符串逗號分隔，例如：“×X市××區(qū)，××市××區(qū)”是字符串申報行程的時間，時間格式為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":"張"http://姓名脫敏信息"warnType":"確診",//風險類型"fbrq":"2020-02-10",//發(fā)病日期"qzrq":"2020-02-10",//確診日期"jcrq":"2020-02-10",//接觸日期"jclx":"聚餐",//接觸類型6"mdtrtDate":"2020-02-10",//入院時間"dscgDate":"2020-02-20"http://出院時間"healthyStaus":"00",//10:紅碼(高風險);01:黃碼(中風險);00:綠碼(低風險)"date":"2020-03-02",//健康風險等級評估時間(取值見GB/T38962—2020)"reason":"",//健康風險等級評估原因(取值見GB/T38962—2020)"dataSource":"××省"http://來源省份"reason":"體溫超過37.3℃""dataSource":"××省""stopoverCityName":"××市，X×市","stopoverCounty":"3"stopoverCountyName":"×X市××區(qū)，××市××區(qū)","fxdj":"0,0"http://風險等級，0和空：代表未查詢到風險信息1:低風險2:中風險3:高風險"stopoverCityName":"XX市，XX市","stopoverCounty":"3"stopoverCountyName":"××市××區(qū)，××市××區(qū)",}示例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返回數據格式統(tǒng)一采用JSON格式。用戶健康信息糾錯接口的參數要求見表11。表11用戶健康信息糾錯服務參數要求類別說明是字符串是字符串是字符串按GB/T38961—2020中4.2確定的形式是字符串是字符串問題標題是字符串問題詳細描述是字符串糾錯反饋時間，格式YYYY-MM-DDHH:MM:SS是字符串當前所在城市，使用行政區(qū)劃代碼是字符串電話號碼否字符串其他說明輸出是字符串是字符串返回數據格式統(tǒng)一采用JSON格式。(資料性附錄)健康碼BizExtData字段使用說明健康碼中用戶信息以“姓名|身份證件號碼|號碼類型|國籍代號^授權時間”的格式組成，用公鑰加密取得加密串后，填到“BizExtData”字段，并發(fā)送制碼請求。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狀態(tài)碼：404、500、503網關：網關層系統(tǒng)繁忙(過載保護),對應HTTP狀態(tài)碼：503網關：無法解析的請求、缺少關鍵字段，對應HTTP狀態(tài)碼：400網關：身份獲取失敗、驗簽失敗等，對應HTTP狀態(tài)碼：401網關：應用無權限訪問，對應HTTP狀態(tài)碼：403網關：服務調用次數上限，對應HTTP狀態(tài)碼：403申請服