云his平台接口

1、HIS标准接口文档资料修订记录版本修订日期修订内容修订人2015-12-17初稿程文强2016-03-161、就诊记录列表2、处方查询3、缴费查询4、住院记录查询接口5、住院每日费用查询魏建2016-03-17增加体检中心接口黎辉2016-05-051、检验，检查才艮告查询2、检验，检查报告明细查询黎辉获取患者信息（app,服务窗口，微信公众号通用 ）更新病人基本信息（app,服务窗口，微信公众号通用）.应用场景HIS为医院核心业务承载系统，打通了整个就医的各个环节，但只能在内部业务 系统中使用，随着移动互联网的快速发展，人们越来越习惯于通过手机去快速完成 一些事情，外部系统接入 HIS的需求

2、越来越强烈，为了解决这一问题，一套标准的 HIS对外接口应运而生，本接口将说明 HIS对外的接口标准。接口的使用采用RESTful架构，是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。数据加密将url地址的参数key进行字典排序后签名；接收方对签名进行验证。signature签名方法（例子使用 PHP伪代码）signature=Sha1 注：params -对key进行字典排序后前的值 keyvalue对应。如：url 为 a=1&c=3&b=2,params 贝U为 a=1b=2c=3time -当前时间戳（秒级别）k

3、ey -双方约定的加密串医院HIS接口定义各类接口信息基本信息接口获取所有科室列表（app,服务窗口，微信公众号通用）实体：获取所有科室列表接口地址/allDept接口描述於取所有科室列表请求消息:请求示例GET无标签名数据类型长度必填说明应答消息:说明示例json格式("status":"0","error_msg":"","data":"dept_id":"", "dept_name":"", "dep

4、t_intro":"", "dept_address":"", "dept_position":"", "dept_tel":"")标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空dept_idstring30Y科室ID/唯一标识符dept_nam estring20Y科室名称dept_int rostring30N科室介绍dept_add ressstring50N

5、科室地址dept_positionint11N科室经纬度dept_telstring30N科室电话获取所有医生列表（app,服务窗口，微信公众号通用）实体：获取所有医生列表接口地址/alldoctor接口描述认取所有医生列表请求消息:请求示例GET标签名数据类型长度必填说明应答消息:说明示例json格式("status":"0","error_msg":"","data":"doctor_id":"10001","doctor_name"

6、;:"李浩","title":" 教授"，"be_good_at":"","description":"","dept_name":"内科""doctor_head_img":"","dept_id":"10","profession":"",标签名数据类型长度必填说明statusInt4Y交易结果

7、：0:成功1:失败error_msgString100Y错误信息，无则空doctor_idint11Y医生iddoctor_n ameString18Y医生姓名titleString16Y职称be_good_atstring30Y擅长descriptionstring255N描术dept_nam estring30N科室名doctor_head_imgstring50N头像dept_idint11N科室IDprofessi onstring30N专业患者接口获取患者信息（app,服务窗口，微信公众号通用）实体：患者资源接口地址/patient接口描述通过就诊卡得到病人信息请求消息:请求示例GE

8、Tcard_no=00000000标签名数据类长度必填说明型card_noString16Y就诊卡卡号应答消息:说明示例json格式("status":"0","error_msg":"","data":"name":"曾A群"，"identity_c"card_no":"000002905977”,"create_date":"2015-05-02","patien

9、t_id":"07341271”,)标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空nameString20Y病人姓名identity_cardString18Y身份证号card_noString16Ycreate_dateInt11Y建卡时间（秒级时间戳）patient_Int11N患者编号（无则不返回）idmobilestring30N电话号码更新病人基本信息（app,服务窗口，微信公众号通用）接口说明：更新病人基本信息接口地址/updateUser接口描述根据病人提供的身份证，姓名，卡号，

10、更新他的基本信息请求消息说明示例GETname=E 宏 &card_id=0000&identify_idphone标签名数据类型长度必填说明nameString10Y姓名card_noString2YIdentify_idString16Y身份证号phonestring20Y电话应答消息说明示例json格式"status":"。"，"error_msg":"",字段说明标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空挂

11、号相关接口值班科室查询（app,服务窗口，微信公众号通用）接口说明：可挂号科室资源接口地址/dutyDept接口描述根据挂号时间查询对应时间可挂号的科室信息请求消息说明示例GETdate=2015-12-11&period=am&card_no=0002886946标签名数据类长度必填说明型dateDate10N就诊日期periodString2Nam-上午,pm-下午card_noString16N就诊卡卡号应答消息说明示例json格式"status":"。"，"error_msg":"",&qu

12、ot;data":"dept_duty_id":"2","dept_id":"2","title":"妇科门诊",("dept_duty_id":"3","dept_id":"3","title":"产科门诊"字段说明标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空da

13、ta数据dept_duty_idInt8N值班部门编号dept_idInt8Y部门编号titleString50Y部门名称值班医生查询（app,服务窗口，微信公众号通用）接口说明：可挂号医生资源接口地址/dutyDoctor接口描述获取指定专业下值班医生信息请求消息说明示例GETdept_id=1&date=2015-12-12&period=am标签名数据类型长度必填说明dept_idint8Y部门编号datedate11N挂号日期periodString2Nam-上午,pm-下午dept_duty_idInt8N部门值班编号应答消息说明示例json格式("stat

14、us":"0","errorMsg":"","data":("dept_duty_id":"3308","doctor_id":"3308","name":"梁占光",("dept_duty_id":"3308","doctor_id":"3308","name":"梁占光&qu

15、ot;)标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空dept_duty_idInt8Y医生的值班编号doctor_idInt8Y医生编号nameString20Y医生姓名医生可用号源查询（app,服务窗口，微信公众号通用）接口说明：医生资源接口地址/doctor接口描述查询医生基本信息及值班信息接口调用说明示例GETdoctor_id=1&date=2015-12-12&period=am标签名数据类型长度必填说明doctor_idint8Y医生编号datedate8N挂号日期periodStr

16、ing2N挂号时段（am上午，pm下午）应答消息：说明示例("result":"0","errorMsg":"","data":"info":"name":"张教授",json格式"title":" 四级专家","fee":"","duty":"date":"2015-09-09","am

17、":"yes","pm":"yes","total":"10","use":"1""duty_doc_id":"3294|775","date":"2015-09-10","am":"yes","pm":"yes","total":"10",&quo

18、t;use":"1""duty_doc_id":"3294|775")标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空Info-医生基本信息nameString30Y医生姓名titleString30Y医生职称feeInt10Y医生出诊费用duty-医生出诊列表datedate10Y出诊时间amString3Y上午是否出诊 yes 或 nopmString3Y下午是否出诊 yes 或 nototalInt8Y挂号总数量useInt8Y已挂号数量d

19、uty_doc_idString20Y医生出诊编号（用于挂号）患者可挂号检查（app,服务窗口，微信公众号通用）接口说明：挂号接口接口地址/registration接口描述检查是否可挂号接口调用说明示例GETact=check&duty_doc_id=1&date=2015-12-12&&period=am&card_no=0000000标签名数据类型长度必填说明actString8Ycheck-固定不艾息为挂牙检查duty_doc_idInt8Y医生值班编号dateDateY挂号日期periodString2Yam-上午,pm-下午card_nostr

20、ing20Y应答消息：说明示例json格式("status":"0", "errorMsg":"", "data": "result":"1", ) )标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败errorMsgString100Y错误信息，无则空resultString10Y1-可挂号，其他-不可挂号锁定号源（app,服务窗口，微信公众号通用）接口说明：挂号锁号接口地址/registration接口描述锁定某个挂号号源说明示

21、例PUTact=lock&duty_doc_id=1&doc_id=1&day=2015-12-12&&period=am&type=1标签名数据类型长度必填说明actString8Ylock-固定不艾息为锁万duty_doc_idInt8Y医生值班编号doc_idint8Y医生编号dayDateN挂号日期periodString2Nam-上午,pm-下午typeint1Y1为短时间锁号2为长时间锁号（预约）应答消息：说明示例json格式("status":"0","error_msg"

22、:"","data":"appt_id":"3203|2339|7",标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空appt_idString100Y锁定的号，空则锁号失败取消锁号取号（app,服务窗口，微信公众号通用）接口说明：挂号锁号接口地址/registration接口描述取得某一个挂号号源说明示例PUTact=fetch&appt_id=1&card_no=00000000&bank_no标签名数据类型

23、长度必填说明actString8Yfetch-固定不艾息为取万appt_idString20Y号源编号（锁定）card_noString20Y挂号的就诊卡卡号bank_noString50Y收费流水号feeString10Y收费金额应答消息：说明示例json格式"status":"。"，"error_msg":"","data":"date":"2015","ser_no":"63902","appt_id

24、"card_no":"000002727654","pat_name":"黄丽鹃""queue_no":"3","dept_name":"产科门诊","doctor_name":" 张力（上午）"，"doctor_title":"产科三级专家","address":"二楼 02 诊断室","fee"

25、:"43","invoice_no"time_info":"请于上午8点至9点到医院就诊",)标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空data-挂号基本信息datedate8Y挂号时间appt_idString20Y号源编号（锁定）ser_noString20N全院挂号序号card_noString20N患者就诊卡卡号pat_nameString20N患者姓名queue_noString20Y当前科室挂号序号dept_nam eStrin

26、g20Y就诊科室名称doctor_n ameString20Y医生姓名doctor_titleString20Y医生级别addressString30Y就诊科室位置feeString30Y挂号费用invoice_ noString50Y发票编号time_inf oString50Y就诊时间提醒信息取消挂号（app,服务窗口，微信公众号通用）接口说明：取消挂号（包括当日和预约）接口地址/cancelReg接口描述用户取消挂号说明示例PUTorder_id ='改期标签名数据类型长度必填说明order_idString50Y订单号reasonString取消原因应答消息：说明示例json格

27、式"status":"0","error_msg":"",)标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空自费用户线下预约记录（线下挂号转线上支付）（app,服务窗口，微信公众号通用）接口说明：（支持线下窗口挂号转线上支付）接口地址/lineUnPayRegList接口描述支持线下窗口挂号转线上支付说明示例GETcard_no=0000032321标签名数据类型长度必填说明card_noString20Y就诊卡卡号应答消息:说明示例j

28、son格式("status":"。"，"errorMsg":"查询成功.","data":"appt_id":"3131343","card_no":"07480189","pat_name":"汤雪梅"，"pat_age":"26 岁 10 月"，"pat_sex":"女"，"queue

29、_no":"3","fee":"""is_pay":"0",标签名数据类型长度必填说明statusInt4Y交易结果：0:成功1:失败error_msgString100Y错误信息，无则空data线下挂号基本信息card_noString20Y就诊Radv_idString20Y医嘱编号pat_nameString10Y患者姓名pat_ageString20N患者年龄pat_sexString3N患者性别queue_noInt3Y号源序号feeStringY挂号费用is_payString3Y是否支付（1支付，0则未支付）无卡挂号用户注册（app,服务窗口，微信公众号通用）接口地址/patientRegister接口描述无卡用户注册请求消息:请求示例POST标签名数据类型长度必填说明nameStri