一、接口要求
1、HIS系統(tǒng)提供webservice接口,接口url中[address]代表webservice服務(wù)器地址(包含端口)。
2、在接口說明中訪問方式中“輪詢”為排隊(duì)叫號系統(tǒng)輪詢調(diào)用接口以便實(shí)時(shí)獲取最新數(shù)據(jù),“非輪詢”為排隊(duì)叫號系統(tǒng)只會在需要的時(shí)候調(diào)用。
3、所有接口中請求參數(shù)都是名為data的一個json字符串;響應(yīng)的參數(shù)包括result、errorCode、errorText、data四個參數(shù),其中data為json格式的字符串。
4、data參數(shù)中json字段說明中“非空”字段為必須傳遞的字段,“可空”的字段可以不傳。
5、診室信息在his系統(tǒng)中沒有維護(hù)的話,接口可無。
二、接口說明
Webservice地址:http://[address]/huaxu?wsdl
每個接口中請求參數(shù)都名為data的json數(shù)據(jù);返回參數(shù)有四個,分別為result:boolean類型,表示執(zhí)行結(jié)果,true為執(zhí)行成功;errorCode:int類型,0表示執(zhí)行成功,1表示執(zhí)行失敗等(其他值詳見附件);errorText:string類型,表示服務(wù)器提示語,返回“執(zhí)行成功”、“執(zhí)行失敗”等;data:string類型,傳遞的業(yè)務(wù)數(shù)據(jù),說明詳見每個接口中的data參數(shù)說明。
1、獲取科室信息
·方法:departmentList
·訪問方式:非輪詢
·請求參數(shù):空
·返回data參數(shù):
示例:
[
{
DEPARTMENT_ID: "1009",
NAME: "皮膚科"
}, …
]
字段 數(shù)據(jù)類型 允許空 說明 示例數(shù)據(jù)
DEPARTMENT_ID String 非空 科室編號 1009
NAME String 非空 科室名稱 兒科
2、獲取醫(yī)生信息
·方法:doctorList
·訪問方式:非輪詢
·請求參數(shù):空
·返回data參數(shù):醫(yī)生列表
示例:
[
{
DOCTOR_ID: "100301",
DEPARTMENT_ID: "1009"
USER_NAME: "張三",
USER_PHOTO: "",
USER_INTRODUCE: "",
TITLE: "主任醫(yī)師",
LEVEL: "1"
}, …
]
字段 數(shù)據(jù)類型 允許空 說明 示例數(shù)據(jù)
DOCTOR_ID String 非空 醫(yī)生編號 020205
DEPARTMENT_ID String 非空 醫(yī)生所屬科室,對應(yīng)hx_department中的DEPARTMENT_ID。 1009
USER_NAME String 非空 醫(yī)生姓名 張三
USER_PHOTO String 可空 醫(yī)生照片地址,用于屏幕顯示。
USER_INTRODUCE String 可空 醫(yī)生簡介,用于屏幕顯示。
TITLE String 可空 醫(yī)生職位,用于屏幕顯示。 主任醫(yī)師
LEVEL int 可空 醫(yī)生所看類型,0為普通號,1為專家號。 1
3、獲取診室信息。
·方法:roomList
·訪問方式:非輪詢
·請求參數(shù):空
·返回data參數(shù):診室列表
示例:
[
{
ROOM_ID: "020102",
NAME: "兒科一號診室"
DEPARTMENT_ID: "1009"
}, …
]
字段 數(shù)據(jù)類型 允許空 說明 示例數(shù)據(jù)
ROOM_ID String 非空 診室編號 020102
NAME String 非空 科室名稱 兒科一號診室
DEPARTMENT_ID String 可空 所屬科室編號 1009
4、獲取掛號信息
·方法:regList
·訪問方式:非輪詢
·請求參數(shù):空
·返回data參數(shù):掛號信息列表
示例:
[
{
PATIENT_ID: "1000002589",
DEPARTMENT_ID: "1009",
DOCTOR_ID: "1009",
ROOM_ID: "010102",
P_NAME: "李四",
P_AGE: "25",
P_SEX: "女",
P_ID: "420411199302015236",
CARD_NUMBER: "100026589",
SOCIAL_NUMBER: "2026306987",
INPAT_NUMBER: "1000002589",
REG_TYPE: "1",
REG_TIME: "2018-06-09 08:19:00",
IS_BOOKING: "0",
STATE: "2"
}, …
]
字段 數(shù)據(jù)類型 允許空 說明 示例數(shù)據(jù)
PATIENT_ID String 非空 掛號流水號,必須唯一。 1000002589
P_NAME String 非空 患者姓名 李四
DEPARTMENT_ID String 非空 掛號科室編號 1009
DOCTOR_ID String 可空 所掛號的醫(yī)師編號,如沒指定醫(yī)師可為空。 020205
ROOM_ID String 可空 指定診室的編號。 010102
P_AGE int 可空 患者年齡 25
P_SEX String 可空 患者性別 女
P_ID String 可空 患者身份證號碼 420411199302015236
CARD_NUMBER String 可空 患者就診卡號,用于查詢。 100026589
SOCIAL_NUMBER String 可空 社保號,用于查詢。 2026306987
INPAT_NUMBER String 可空 住院號,用于查詢。 1000002589
REG_TYPE int 非空 掛號類型,0為普通號;1為專家號。 1
REG_TIME String 非空 掛號時(shí)間;如為預(yù)約號則為取號時(shí)間。 2018-06-09 08:19:00
IS_BOOKING int 非空 是否為預(yù)約號的標(biāo)識,1為預(yù)約號;0為非預(yù)約號。 0
STATE int 非空 掛號信息狀態(tài),0為取消掛號;1為修改狀態(tài),如轉(zhuǎn)科室等;2為正常掛號信息。 2
三、附件
1、errorCode和errorText說明
errorCode errorText 說明
0 執(zhí)行成功 接口執(zhí)行成功,數(shù)據(jù)正常。
1 執(zhí)行失敗 接口執(zhí)行失敗,未知錯誤。
2 參數(shù)錯誤 接口調(diào)用傳遞的參數(shù)錯誤。
3 服務(wù)器內(nèi)部錯誤 服務(wù)器運(yùn)行出錯。