成都市電子居民健康卡接入規(guī)范

1、附件成都市電子居民健康卡接入規(guī)范電子居民健康卡是居民健康卡的重要組成部分，是實體居民健康卡互聯(lián)網(wǎng)化、虛擬化、功能服務(wù)延伸的唯一載體，是信息便民服務(wù)的重要抓手。為有效解決實體卡發(fā)卡難、促進(jìn)居民健康卡使用率、豐富應(yīng)用場景，規(guī)劃采用“電子居民健康卡+實體居民健康卡+健康成都平臺”相結(jié)合的方式開展建設(shè)與推廣應(yīng)用，實現(xiàn)成都市“同城通卡同應(yīng)用”的目標(biāo)。第一部分 應(yīng)用場景設(shè)計電子居民健康卡可以在以下多項醫(yī)療功能中實現(xiàn)重要支撐：居民健康卡虛擬化將居民健康卡實體卡與電子居民健康卡綁定，實現(xiàn)身份的統(tǒng)一，數(shù)據(jù)的統(tǒng)一。預(yù)約掛號身份識別電子居民健康卡信息直接對接醫(yī)院院內(nèi)系統(tǒng)，生成院內(nèi)識別賬號，實現(xiàn)用戶在線建檔、在線預(yù)約

2、掛號。個人健康檔案查詢通過成都市人口信息平臺賬號與居民健康卡應(yīng)對，通過電子居民健康卡的用戶安全管理，逐步開放部分個人健康信息。實時信息查詢根據(jù)醫(yī)院現(xiàn)階段就診排隊信息，通過電子居民健康卡識別，為掛號用戶及預(yù)約掛號用戶提供排隊信息查詢，方便居民及時了解排隊信息情況。檢查檢驗報告查詢通過電子居民健康卡與醫(yī)院賬號的應(yīng)對，電子居民健康卡用戶在線查看自己報告是否生成，報告結(jié)果如何。家庭醫(yī)生簽約管理電子居民健康卡作為唯一標(biāo)志，因?qū)τ嘘P(guān)基層簽約機(jī)構(gòu)，實現(xiàn)簽約與賬號的對應(yīng)。方便未來家庭醫(yī)生建檔、服務(wù)。其他門診服務(wù)電子居民健康卡同時可以提供包含智能導(dǎo)診、門診繳費(fèi)記錄、檢查檢驗預(yù)約、檢查檢驗排隊、門診繳費(fèi)等其他院內(nèi)

3、實現(xiàn)的互聯(lián)網(wǎng)服務(wù)的身份識別。住院服務(wù)電子居民健康卡與院內(nèi)檔案打通，可通過電子居民健康卡在線查詢在院繳費(fèi)押金、補(bǔ)繳記錄、住院清單等住院部分的數(shù)據(jù)查詢。醫(yī)院有關(guān)信息醫(yī)院滿意度、醫(yī)生滿意度等院內(nèi)信息上報的身份識別。第二部分 電子居民健康卡主索引平臺接入功能說明成都市電子居民健康卡主索引平臺（以下簡稱：“主索引平臺”）作為成都市衛(wèi)計委健康成都平臺的重要子系統(tǒng)之一，為電子居民健康卡提供身份識別、數(shù)據(jù)存儲、實時互聯(lián)等技術(shù)支撐和安全保障。1 功能描述1.1 電子居民健康卡用戶認(rèn)證1.1.1 概述為了保護(hù)用戶信息及相關(guān)數(shù)據(jù)，居民健康卡用戶在健康成都平臺前端或其它服務(wù)提供商進(jìn)行居民健康卡綁定時，需要在健康成都平

4、臺的主索引平臺進(jìn)行用戶認(rèn)證，保證其用戶信息真實性。1.1.2 功能設(shè)計主索引平臺將對衛(wèi)計委認(rèn)可的服務(wù)提供商開放網(wǎng)絡(luò)端口訪問權(quán)限及用戶認(rèn)證接口訪問權(quán)限，并提供RESTFULL風(fēng)格HTTPS接口及SOAP接口兩種訪問方式進(jìn)行業(yè)務(wù)開放。主索引平臺認(rèn)證規(guī)則：A：用戶提交健康卡卡號及手機(jī)號與卡管平臺登記的健康卡卡號及手機(jī)號相匹配。B：主索引平臺將發(fā)送短信驗證碼到與健康卡卡號匹配的手機(jī)號上。C：用戶提交手機(jī)號進(jìn)行驗證。根據(jù)后期業(yè)務(wù)發(fā)展，主索引平臺還將提供對用戶提供診療記錄驗證及銀聯(lián)用戶認(rèn)證功能。1.1.3 角色定位【主索引平臺】：主索引平臺能力開放中心將提供電子居民健康卡用戶認(rèn)證接口，供健康成都平臺及第三

5、方調(diào)用?！痉?wù)商】：服務(wù)商根據(jù)主索引平臺的接口文檔研發(fā)電子居民健康卡用戶認(rèn)證接口，并提供相關(guān)業(yè)務(wù)頁面供用戶使用?！究ü芷脚_】：卡管平臺提供居民健康卡信息查詢接口1.2 電子居民健康卡用戶發(fā)卡1.2.1 概述主索引平臺支持多平臺多服務(wù)商接入，對所有需使用電子居民健康卡業(yè)務(wù)的居民健康卡用戶進(jìn)行電子居民健康卡的發(fā)放業(yè)務(wù)。服務(wù)商及健康成都平臺獲取到電子居民健康卡后在客戶端生成二維碼提供給用戶使用。1.2.2 功能設(shè)計主索引平臺將對衛(wèi)計委認(rèn)可的服務(wù)提供商開放網(wǎng)絡(luò)端口訪問權(quán)限及電子居民健康卡用戶發(fā)卡接口訪問權(quán)限，并提供RESTFULL風(fēng)格Https接口及SOAP接口兩種訪問方式進(jìn)行業(yè)務(wù)開放。1.2.3 角

6、色定位【主索引平臺接口】：主索引平臺能力開放平臺將提供電子居民健康卡發(fā)卡接口供健康成都平臺及第三方調(diào)用,請參照電子居民健康卡用戶發(fā)卡接口說明。電子居民健康卡生成規(guī)則：根據(jù)用戶認(rèn)證后的居民健康卡卡號，系統(tǒng)時間戳，加密私鑰，采取對稱加密算法，將居民健康卡卡號，有效時間加密成二維碼識別串，有效時間為五分鐘?！痉?wù)商】：服務(wù)商根據(jù)主索引平臺接口文檔，研發(fā)電子居民健康卡用戶發(fā)卡接口，并提供相關(guān)業(yè)務(wù)頁面供用戶使用。1.3 電子居民健康卡用戶識別1.3.1 概述當(dāng)用戶使用二維碼在醫(yī)院窗口進(jìn)行業(yè)務(wù)掃碼后，窗口將二維碼字符串通過HIS傳輸?shù)桨l(fā)卡中心進(jìn)行用戶識別。1.3.2 功能設(shè)計主索引平臺將對衛(wèi)計委認(rèn)可的服務(wù)

7、提供商開放網(wǎng)絡(luò)端口訪問權(quán)限及用戶識別接口訪問權(quán)限，并提供RESTFULL風(fēng)格Https接口及SOAP接口兩種訪問方式進(jìn)行業(yè)務(wù)開放。1.3.3 角色定位【主索引平臺接口】：主索引平臺能力開放平臺將提供電子居民健康卡下行接口供健康成都平臺及第三方調(diào)用,請參照電子居民健康卡用戶識別接口說明。識別規(guī)則：根據(jù)二維碼識別串，使用發(fā)卡時的加密私鑰進(jìn)行解碼，獲得系統(tǒng)時間戳，居民健康卡卡號信息，并在后臺服務(wù)判斷用戶是否是已通過認(rèn)證的用戶及時間有效性，有效時間為五分鐘。 如果通過認(rèn)證且時間在規(guī)定范圍內(nèi)，則返回居民健康卡卡號給醫(yī)院端。【服務(wù)商】：服務(wù)商根據(jù)主索引平臺接口文檔研發(fā)電子居民健康卡用戶識別接口，并提供對應(yīng)

8、接口頁面供醫(yī)院調(diào)用。【醫(yī)院】醫(yī)院窗口需要能接受二維碼，并通過服務(wù)商提供的接口到主索引平臺進(jìn)行電子居民健康卡用戶識別。第三部分 電子居民健康卡接口標(biāo)準(zhǔn)第一章 概 述1.1范圍本文檔適用于參與主索引平臺能力開放平臺設(shè)計和研發(fā)人員，系統(tǒng)維護(hù)人員及接入能力開放平臺的外部應(yīng)用的開發(fā)人員。1.2起草單位本文檔的起草單位為成都市衛(wèi)生和計劃生育委員會。1.3解釋權(quán)本文檔的解釋權(quán)屬于成都市衛(wèi)生和計劃生育委員會。1.4版權(quán)本文檔的版權(quán)屬于成都市衛(wèi)生和計劃生育委員會。第二章 接 口2.1概述系統(tǒng)接口使用http、webservice方式，傳送數(shù)據(jù)編碼統(tǒng)一為UTF-8。請求數(shù)據(jù)說明：調(diào)用能力平臺接口，有3個必傳參數(shù)，

9、分別是dcode、dkey、pocde。dcode為安全訪問參數(shù)設(shè)備編碼。dkey為安全訪問參數(shù)設(shè)備密鑰。pcode為平臺code，由能力開放平臺提供。響應(yīng)數(shù)據(jù)說明： "data": " xxx": "", " xxx ": "" , "state": 1, "msg": "success"返回數(shù)據(jù)格式說明：data是主體數(shù)據(jù)，服務(wù)器響應(yīng)客戶端請求的具體業(yè)務(wù)數(shù)據(jù)。 state是響應(yīng)代碼，state為1表示成功、非1表示失敗。msg是響應(yīng)

10、描述，成功時，提示請求成功，失敗時，提示失敗原因。2.2電子居民健康卡2.2.1用戶識別接口說明根據(jù)二維碼字符串進(jìn)行用戶識別接口地址類型接口地址接口方法httpcrypt/decrypt.dowebservicecrypt/decrypt?wsdldecrypt輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcode平臺編碼否平臺編碼hid醫(yī)療機(jī)構(gòu)代碼否醫(yī)療機(jī)構(gòu)代碼encrypt二維碼字符串否掃描二維碼后獲得的加密字符串返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回數(shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失

11、敗msg結(jié)果描述否成功時，提示請求成功失敗時，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請求的具體數(shù)據(jù)data結(jié)構(gòu)體說明屬性類型可否為空備注idCardString否身份證usernameString否姓名psnGenString否性別birthdayString否出生日期nationCodeString否民族address1String否家庭地址address2String是戶口地址psnName1String是聯(lián)系人姓名psnRel1String是聯(lián)系人關(guān)系psnPhoneString是聯(lián)系人電話degreeString是文化程度marryString是婚姻狀況jobString是職業(yè)cnumSt

12、ring否卡號cardTypeString否卡類型輸出舉例 "data": "address1": "", "address2": "", "nationCode": "", "username": "", "psnName1": "", "marry": "", "idCard": "", &qu

13、ot;psnRel1": "", "psnPhone1": "", "psnGen": "", "job": "", "birthDay": "", "degree": "", “cnum”,”, “cardType”:” , "state": 1, "msg": "success"2.2.2用戶加密接口說明

14、根據(jù)用戶信息進(jìn)行加密接口地址類型接口地址接口方法httpcrypt/encrypt.dowebservicecrypt/encrypt?wsdlencrypt輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcode平臺編碼否平臺編碼uid平臺用戶ID否平臺用戶IDidcard用戶身份信息否用戶身份信息返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回數(shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時，提示請求成功失敗時，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請求的具體數(shù)據(jù)data結(jié)構(gòu)體說明屬性類型可

15、否為空備注encryptString否加密后的用戶信息輸出舉例"data":"encrypt":"", "state": 1, "msg": " success "2.2.3用戶認(rèn)證1.0獲取認(rèn)證碼接口說明用戶認(rèn)證獲取認(rèn)證碼接口地址類型接口地址接口方法httpcrypt/code.dowebservicecrypt/code.wsdlcode輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcod

16、e平臺編碼否平臺編碼uid平臺用戶ID否平臺用戶IDidcard用戶身份信息否用戶身份信息phone用戶手機(jī)號否用戶手機(jī)號name用戶姓名否用戶姓名返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回數(shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時，提示請求成功失敗時，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請求的具體數(shù)據(jù)data結(jié)構(gòu)體說明屬性類型可否為空備注vtokenString否驗證碼token輸出舉例 "data": “vtoken”: "cd18904806a1b4306a1f7fc4741caef1", "

17、state": 1, "msg": "success"提交認(rèn)證碼接口說明提交認(rèn)證碼，完成認(rèn)證接口地址類型接口地址接口方法httpcrypt/auth.dowebservicecrypt/auth.wsdlauth輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcode平臺編碼否平臺編碼vtoken驗證碼token否驗證碼token，調(diào)用獲取驗證碼接口后返回vcode驗證碼否調(diào)用獲取驗證碼接口后，向用戶手機(jī)發(fā)送的驗證碼返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回數(shù)

18、據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時，提示請求成功失敗時，提示失敗原因輸出舉例 "state": 1, "msg": "success"2.2.4用戶認(rèn)證2.0獲取認(rèn)證題目接口說明用戶認(rèn)證獲取認(rèn)證題目接口地址類型接口地址接口方法httpcrypt/getQues.dowebservicecrypt/getQues.wsdlgetQues輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcode平臺編碼否平臺編

19、碼uid平臺用戶ID否平臺用戶IDidcard用戶身份信息否用戶身份信息phone用戶手機(jī)號否用戶手機(jī)號name用戶姓名否用戶姓名返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回數(shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時，提示請求成功失敗時，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請求的具體數(shù)據(jù)data結(jié)構(gòu)體說明屬性類型可否為空備注quCodeString否問題編號questionString否問題描述ItemString否答案選項輸出舉例    "data":   &

20、#160;                 "quCode": "961674102731204",            "question": "下面那個科室是你2015年5月17日在成都市第一人民醫(yī)院就診的科室&q

21、uot;,            "item":                 "消化內(nèi)科",              

22、60; "兒科",                "泌尿內(nèi)科",                "外科"         

23、;           ,                    "quCode": "638439651063459",          

24、;  "question": "你于2015年4月13日在哪個醫(yī)院的消化科就診?",            "item":                 "成都市第一人民醫(yī)院", 

25、0;              "成都市第二人民醫(yī)院",                "成都市第三人民醫(yī)院",            &#

26、160;   "成都市第四人民醫(yī)院"                        ,    "state": 1,    "msg": "success"提交認(rèn)證答案接口說明用戶認(rèn)證獲取認(rèn)證題目接口地址類型接口地址接口方法httpcrypt/saveResult.dowebservicecrypt/saveResult.wsdlsaveResult輸入?yún)?shù)字段說明可否為空備注dcode設(shè)備編碼否安全訪問參數(shù)（設(shè)備編碼）dkey設(shè)備密鑰否安全訪問參數(shù)（設(shè)備密鑰）pcode平臺編碼否平臺編碼uid平臺用戶ID否平臺用戶IDidcard用戶身份信息否用戶身份信息jsonArr認(rèn)證答案否認(rèn)證答案jsonArr格式范例 "quCod