億家健康對接接口方案0.1.docx

1、3-號咄®11初稿【5發(fā)布1修訂編撰：張愛民eu業(yè)由件編撰日期：2017-12-08保密級別：機(jī)密文檔版本：1.0文件編號：Q/BS-QH-3-08億家健康對接接口方案創(chuàng)業(yè)軟件集團(tuán)項目組版本歷史日期版本說明作者2018-02-18VI.0初稿張愛民1.概述1.1. 編寫目的HL云HIS（以下簡稱HIS）與億家健康A(chǔ)PP（以下簡稱APP）進(jìn)行對接接口開發(fā)，系統(tǒng)設(shè)計過程中需滿足億家健康診療業(yè)務(wù)實(shí)時性要求。1.2. 術(shù)語和定義略13.注意事項1、每個業(yè)務(wù)接口分為服務(wù)提供者、調(diào)用方、服務(wù)名、方法名、傳入?yún)?shù)、返回參數(shù)。2、考慮接口方法并發(fā)性問題，防止主鍵沖突。3、HIS接受一次請求的最大數(shù)據(jù)

2、條數(shù)為200條。2. 概述2.1.業(yè)務(wù)場景個人：個人登錄APP端，選擇科室或醫(yī)生，可以選擇醫(yī)生進(jìn)行簽約操作，簽約效期內(nèi)在線期間可以實(shí)時向簽約醫(yī)生發(fā)起就診申請；也可以查看醫(yī)生的排班信息并操作預(yù)約，預(yù)約成功后，在預(yù)約效期內(nèi)登錄APP,確認(rèn)待診后等待醫(yī)生發(fā)起就診。通過視頻通話、語音、在線聊天等完成在線診療，等待醫(yī)生完成病歷書寫和醫(yī)囑開立，可以查看HIS端推送的本次診療的費(fèi)用以及醫(yī)囑，并通過APP完成支付。醫(yī)生：醫(yī)生登錄HIS端，查看待診病人列表，選擇病人就診，通過視頻通話、語音、在線聊天等完成在線診療，書寫病歷，升立醫(yī)囑后結(jié)束就診。2.2.業(yè)務(wù)流程APP所需的數(shù)據(jù)，按流轉(zhuǎn)時效來分，分為兩部分：1、需

3、要實(shí)時交換的，2、不需要實(shí)時交換的。所有實(shí)時的數(shù)據(jù)交換都采用消息中間件或"B服務(wù)來實(shí)現(xiàn)；所有非實(shí)時的數(shù)據(jù)交換采用消息中間件、WEB服務(wù)或數(shù)據(jù)交換平臺來實(shí)現(xiàn)。具體的數(shù)據(jù)接口類型以及實(shí)現(xiàn)方式詳見3.1接口清單。云平臺驗(yàn)證機(jī)制暫不考慮。2.5. 實(shí)時數(shù)據(jù)質(zhì)控2.6.1.實(shí)時數(shù)據(jù)交換的質(zhì)控因通過接口產(chǎn)生交萬數(shù)據(jù)實(shí)時進(jìn)入HIS庫，對于上傳的數(shù)據(jù)，特別是不使用通用字典的數(shù)據(jù)，需進(jìn)行一定的質(zhì)控，以避免上傳無效數(shù)據(jù)，影響系統(tǒng)整體運(yùn)轉(zhuǎn)的情況。主要需考慮以卜幾個問題： 每一個數(shù)據(jù)接口的數(shù)據(jù)質(zhì)量要求（必填項、允許值范圍等）。 不合格數(shù)據(jù)的處理反饋機(jī)制。 不合格數(shù)據(jù)的修改、重報機(jī)制。以上問題需結(jié)合實(shí)際業(yè)務(wù)進(jìn)

4、行分析解決。2.62應(yīng)用系統(tǒng)的質(zhì)控初步考慮同上。2.6. 傳輸效率驗(yàn)證因接口設(shè)計階段尚未考慮和涉及較為復(fù)雜的網(wǎng)絡(luò)環(huán)境，該問題尚未考慮，建議考慮搭建一個簡易測試環(huán)境進(jìn)行測試。2.7. 數(shù)據(jù)交換日志 對每一筆數(shù)據(jù)交換均進(jìn)行詳細(xì)的日志記錄； 日志記錄允許APP、HIS端查詢； 為減少數(shù)據(jù)昆，對超出一定時間的日志進(jìn)行歸檔。2.8. 網(wǎng)絡(luò)或應(yīng)用接口故障應(yīng)用系統(tǒng)接口應(yīng)具備容錯性，當(dāng)發(fā)生網(wǎng)絡(luò)故障或第三方應(yīng)用故障時，能保證系統(tǒng)在一定范圍內(nèi)的正常運(yùn)轉(zhuǎn)，并在故障恢虹后盡快恢史系統(tǒng)正常運(yùn)轉(zhuǎn)。 無法獲取數(shù)據(jù)時，顯示相應(yīng)的提示消息，如不影響業(yè)務(wù)的開展，允許繼續(xù)執(zhí)行業(yè)務(wù)操作； 無法傳輸數(shù)據(jù)時，對待傳輸數(shù)據(jù)進(jìn)行標(biāo)記，并在系統(tǒng)恢復(fù)后續(xù)傳； 發(fā)生故障時均需記錄詳細(xì)日志以便排查錯誤原因。3. 接口設(shè)計3.1.