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