億家健康對(duì)接接口方案0.1.docx

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

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

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

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