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

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

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

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

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

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

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

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

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

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

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

11、敗msg結(jié)果描述否成功時(shí)，提示請(qǐng)求成功失敗時(shí)，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請(qǐ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否卡號(hào)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平臺(tái)編碼否平臺(tái)編碼uid平臺(tái)用戶ID否平臺(tái)用戶IDidcard用戶身份信息否用戶身份信息返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回?cái)?shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時(shí)，提示請(qǐng)求成功失敗時(shí)，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請(qǐ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平臺(tái)編碼否平臺(tái)編碼uid平臺(tái)用戶ID否平臺(tái)用戶IDidcard用戶身份信息否用戶身份信息phone用戶手機(jī)號(hào)否用戶手機(jī)號(hào)name用戶姓名否用戶姓名返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回?cái)?shù)據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時(shí)，提示請(qǐng)求成功失敗時(shí)，提示失敗原因data返回結(jié)構(gòu)否響應(yīng)請(qǐng)求的具體數(shù)據(jù)data結(jié)構(gòu)體說明屬性類型可否為空備注vtokenString否驗(yàn)證碼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平臺(tái)編碼否平臺(tái)編碼vtoken驗(yàn)證碼token否驗(yàn)證碼token，調(diào)用獲取驗(yàn)證碼接口后返回vcode驗(yàn)證碼否調(diào)用獲取驗(yàn)證碼接口后，向用戶手機(jī)發(fā)送的驗(yàn)證碼返回參數(shù)JSON格式字符串見返回參數(shù)說明。返回?cái)?shù)

18、據(jù)格式字段說明可否為空備注state結(jié)果代碼否1成功 非1失敗msg結(jié)果描述否成功時(shí)，提示請(qǐng)求成功失敗時(shí)，提示失敗原因輸出舉例 "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平臺(tái)編碼否平臺(tái)編

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

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

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

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

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

24、;  "question": "你于2015年4月13日在哪個(gè)醫(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平臺(tái)編碼否平臺(tái)編碼uid平臺(tái)用戶ID否平臺(tái)用戶IDidcard用戶身份信息否用戶身份信息jsonArr認(rèn)證答案否認(rèn)證答案jsonArr格式范例 "quCod