云his平台接口.docx
- 文档编号:27336710
- 上传时间:2023-06-29
- 格式:DOCX
- 页数:98
- 大小:39.56KB
云his平台接口.docx
《云his平台接口.docx》由会员分享,可在线阅读,更多相关《云his平台接口.docx(98页珍藏版)》请在冰豆网上搜索。
云his平台接口
HIS标准接口文档
资料修订记录
版本
修订日期
修订内容
修订人
2015-12-17
初稿
程文强
2016-03-16
1、就诊记录列表
2、
3、处方查询
4、
5、缴费查询
6、
7、住院记录查询接口
8、
9、住院每日费用查询
魏建
2016-03-17
增加体检中心接口
黎辉
2016-05-05
1、检验,检查报告查询
2、检验,检查报告明细查询
黎辉
获取患者信息(app,服务窗口,微信公众号通用)
更新病人基本信息(app,服务窗口,微信公众号通用)
应用场景
HIS为医院核心业务承载系统,打通了整个就医的各个环节,但只能在内部业务系统中使用,随着移动互联网的快速发展,人们越来越习惯于通过手机去快速完成一些事情,外部系统接入HIS的需求越来越强烈,为了解决这一问题,一套标准的HIS对外接口应运而生,本接口将说明HIS对外的接口标准。
接口的使用
采用RESTful架构,是目前最流行的一种互联网软件架构。
它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用。
数据加密
将url地址的参数key进行字典排序后签名;接收方对签名进行验证。
signature签名方法(例子使用PHP伪代码)
signature=Sha1注:
params-对key进行字典排序后前的值keyvalue对应。
如:
url为a=1&c=3&b=2,params则为a=1b=2c=3
time-当前时间戳(秒级别)
key-双方约定的加密串
医院HIS接口
定义各类接口信息
基本信息接口
获取所有科室列表(app,服务窗口,微信公众号通用)
实体:
获取所有科室列表
接口地址
/allDept
接口描述
获取所有科室列表
请求消息:
请求
示例
GET
无
标签名
数据类型
长度
必填
说明
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"dept_id":
"",
"dept_name":
"",
"dept_intro":
"",
"dept_address":
"",
"dept_position":
"",
"dept_tel":
""
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
dept_id
string
30
Y
科室ID/唯一标识符
dept_name
string
20
Y
科室名称
dept_intro
string
30
N
科室介绍
dept_address
string
50
N
科室地址
dept_position
int
11
N
科室经纬度
dept_tel
string
30
N
科室电话
获取所有医生列表(app,服务窗口,微信公众号通用)
实体:
获取所有医生列表
接口地址
/alldoctor
接口描述
获取所有医生列表
请求消息:
请求
示例
GET
标签名
数据类型
长度
必填
说明
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"doctor_id":
"10001",
"doctor_name":
"李浩",
"title":
"教授",
"be_good_at":
"",
"description":
"",
"dept_name":
"内科"
"doctor_head_img":
"",
"dept_id":
"10",
"profession":
"",
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
doctor_id
int
11
Y
医生id
doctor_name
String
18
Y
医生姓名
title
String
16
Y
职称
be_good_at
string
30
Y
擅长
description
string
255
N
描术
dept_name
string
30
N
科室名
doctor_head_img
string
50
N
头像
dept_id
int
11
N
科室ID
profession
string
30
N
专业
患者接口
获取患者信息(app,服务窗口,微信公众号通用)
实体:
患者资源
接口地址
/patient
接口描述
通过就诊卡得到病人信息
请求消息:
请求
示例
GET
card_no=00000000
标签名
数据类型
长度
必填
说明
card_no
String
16
Y
就诊卡卡号
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"name":
"曾孟群",
"identity_c
"card_no":
"000002905977",
"create_date":
"2015-05-02",
"patient_id":
"07341271",
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
name
String
20
Y
病人姓名
identity_card
String
18
Y
身份证号
card_no
String
16
Y
卡号
create_date
Int
11
Y
建卡时间(秒级时间戳)
patient_id
Int
11
N
患者编号(无则不返回)
mobile
string
30
N
电话号码
更新病人基本信息(app,服务窗口,微信公众号通用)
接口说明:
更新病人基本信息
接口地址
/updateUser
接口描述
根据病人提供的身份证,姓名,卡号,更新他的基本信息
请求消息
说明
示例
GET
name=王宏&card_id=0000&identify_idphone
标签名
数据类型
长度
必填
说明
name
String
10
Y
姓名
card_no
String
2
Y
卡号
Identify_id
String
16
Y
身份证号
phone
string
20
Y
电话
应答消息
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
字段说明
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
挂号相关接口
值班科室查询(app,服务窗口,微信公众号通用)
接口说明:
可挂号科室资源
接口地址
/dutyDept
接口描述
根据挂号时间查询对应时间可挂号的科室信息
请求消息
说明
示例
GET
date=2015-12-11&period=am&card_no=0002886946
标签名
数据类型
长度
必填
说明
date
Date
10
N
就诊日期
period
String
2
N
am-上午,pm-下午
card_no
String
16
N
就诊卡卡号
应答消息
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
[
{
"dept_duty_id":
"2",
"dept_id":
"2",
"title":
"妇科门诊"
},
{
"dept_duty_id":
"3",
"dept_id":
"3",
"title":
"产科门诊"
}
]
}
}
字段说明
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
data数据
dept_duty_id
Int
8
N
值班部门编号
dept_id
Int
8
Y
部门编号
title
String
50
Y
部门名称
值班医生查询(app,服务窗口,微信公众号通用)
接口说明:
可挂号医生资源
接口地址
/dutyDoctor
接口描述
获取指定专业下值班医生信息
请求消息
说明
示例
GET
dept_id=1&date=2015-12-12&period=am
标签名
数据类型
长度
必填
说明
dept_id
int
8
Y
部门编号
date
date
11
N
挂号日期
period
String
2
N
am-上午,pm-下午
dept_duty_id
Int
8
N
部门值班编号
应答消息
说明
示例
json格式
{
"status":
"0",
"errorMsg":
"",
"data":
[
{
"dept_duty_id":
"3308",
"doctor_id":
"3308",
"name":
"梁占光"
},
{
"dept_duty_id":
"3308",
"doctor_id":
"3308",
"name":
"梁占光"
}
]
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
dept_duty_id
Int
8
Y
医生的值班编号
doctor_id
Int
8
Y
医生编号
name
String
20
Y
医生姓名
医生可用号源查询(app,服务窗口,微信公众号通用)
接口说明:
医生资源
接口地址
/doctor
接口描述
查询医生基本信息及值班信息
接口调用
说明
示例
GET
doctor_id=1&date=2015-12-12&period=am
标签名
数据类型
长度
必填
说明
doctor_id
int
8
Y
医生编号
date
date
8
N
挂号日期
period
String
2
N
挂号时段(am上午,pm下午)
应答消息:
说明
示例
json格式
{
"result":
"0",
"errorMsg":
"",
"data":
{
"info":
{
"name":
"张教授",
"title":
"四级专家",
"fee":
""
},
"duty":
[
{
"date":
"2015-09-09",
"am":
"yes",
"pm":
"yes",
"total":
"10",
"use":
"1"
"duty_doc_id":
"3294||775"
},
{
"date":
"2015-09-10",
"am":
"yes",
"pm":
"yes",
"total":
"10",
"use":
"1"
"duty_doc_id":
"3294||775"
}
]
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
Info-医生基本信息
name
String
30
Y
医生姓名
title
String
30
Y
医生职称
fee
Int
10
Y
医生出诊费用
duty-医生出诊列表
date
date
10
Y
出诊时间
am
String
3
Y
上午是否出诊yes或no
pm
String
3
Y
下午是否出诊yes或no
total
Int
8
Y
挂号总数量
use
Int
8
Y
已挂号数量
duty_doc_id
String
20
Y
医生出诊编号(用于挂号)
患者可挂号检查(app,服务窗口,微信公众号通用)
接口说明:
挂号接口
接口地址
/registration
接口描述
检查是否可挂号
接口调用
说明
示例
GET
act=check&duty_doc_id=1&date=2015-12-12&&period=am&card_no=0000000
标签名
数据类型
长度
必填
说明
act
String
8
Y
check-固定不变意为挂号检查
duty_doc_id
Int
8
Y
医生值班编号
date
Date
Y
挂号日期
period
String
2
Y
am-上午,pm-下午
card_no
string
20
Y
卡号
应答消息:
说明
示例
json格式
{
"status":
"0",
"errorMsg":
"",
"data":
{
"result":
"1",
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
errorMsg
String
100
Y
错误信息,无则空
result
String
10
Y
1-可挂号,其他-不可挂号
锁定号源(app,服务窗口,微信公众号通用)
接口说明:
挂号锁号
接口地址
/registration
接口描述
锁定某一个挂号号源
说明
示例
PUT
act=lock&duty_doc_id=1&doc_id=1&day=2015-12-12&&period=am&type=1
标签名
数据类型
长度
必填
说明
act
String
8
Y
lock-固定不变意为锁号
duty_doc_id
Int
8
Y
医生值班编号
doc_id
int
8
Y
医生编号
day
Date
N
挂号日期
period
String
2
N
am-上午,pm-下午
type
int
1
Y
1为短时间锁号2为长时间锁号(预约)
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"appt_id":
"3203||2339||7",
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
appt_id
String
100
Y
锁定的号,空则锁号失败
取消锁号
取号(app,服务窗口,微信公众号通用)
接口说明:
挂号锁号
接口地址
/registration
接口描述
取得某一个挂号号源
说明
示例
PUT
act=fetch&appt_id=1&card_no=00000000&bank_no
标签名
数据类型
长度
必填
说明
act
String
8
Y
fetch-固定不变意为取号
appt_id
String
20
Y
号源编号(锁定)
card_no
String
20
Y
挂号的就诊卡卡号
bank_no
String
50
Y
收费流水号
fee
String
10
Y
收费金额
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"date":
"2015",
"ser_no":
"63902",
"appt_id
"card_no":
"000002727654",
"pat_name":
"黄丽鹃"
"queue_no":
"3",
"dept_name":
"产科门诊",
"doctor_name":
"张力(上午)",
"doctor_title":
"产科三级专家",
"address":
"二楼02诊断室",
"fee":
"43",
"invoice_no
"time_info":
"请于上午8点至9点到医院就诊",
}
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
data-挂号基本信息
date
date
8
Y
挂号时间
appt_id
String
20
Y
号源编号(锁定)
ser_no
String
20
N
全院挂号序号
card_no
String
20
N
患者就诊卡卡号
pat_name
String
20
N
患者姓名
queue_no
String
20
Y
当前科室挂号序号
dept_name
String
20
Y
就诊科室名称
doctor_name
String
20
Y
医生姓名
doctor_title
String
20
Y
医生级别
address
String
30
Y
就诊科室位置
fee
String
30
Y
挂号费用
invoice_no
String
50
Y
发票编号
time_info
String
50
Y
就诊时间提醒信息
取消挂号(app,服务窗口,微信公众号通用)
接口说明:
取消挂号(包括当日和预约)
接口地址
/cancelReg
接口描述
用户取消挂号
说明
示例
PUT
order_id=’改期’
标签名
数据类型
长度
必填
说明
order_id
String
50
Y
订单号
reason
String
取消原因
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
自费用户线下预约记录(线下挂号转线上支付)(app,服务窗口,微信公众号通用)
接口说明:
(支持线下窗口挂号转线上支付)
接口地址
/lineUnPayRegList
接口描述
支持线下窗口挂号转线上支付
说明
示例
GET
card_no=0000032321
标签名
数据类型
长度
必填
说明
card_no
String
20
Y
就诊卡卡号
应答消息:
说明
示例
json格式
{
"status":
"0",
"errorMsg":
"查询成功.",
"data":
{
"appt_id":
"3131343",
"card_no":
"07480189",
"pat_name":
"汤雪梅",
"pat_age":
"26岁10月",
"pat_sex":
"女",
"queue_no":
"3",
"fee":
""
"is_pay":
"0",
},
}
标签名
数据类型
长度
必填
说明
status
Int
4
Y
交易结果:
0:
成功1:
失败
error_msg
String
100
Y
错误信息,无则空
data线下挂号基本信息
card_no
String
20
Y
就诊卡卡号
adv_id
String
20
Y
医嘱编号
pat_name
String
10
Y
患者姓名
pat_age
String
20
N
患者年龄
pat_sex
String
3
N
患者性别
queue_no
Int
3
Y
号源序号
fee
String
Y
挂号费用
is_pay
String
3
Y
是否支付(1支付,0则未支付)
无卡挂号
用户注册(app,服务窗口,微信公众号通用)
接口地址
/patientRegister
接口描述
无卡用户注册
请求消息:
请求
示例
POST
标签名
数据类型
长度
必填
说明
name
String
16
Y
身份证号
sex
String
10
Y
姓名
birth_date
String
10
Y
出身年月
identity_no
string
30
Y
身份证号码
address
string
50
Y
地址
relation
string
20
Y
关系
occupation
string
20
Y
职业
telephone
string
20
Y
电话
identity_type
int
11
Y
证件类型
nation
string
30
Y
民族
应答消息:
说明
示例
json格式
{
"status":
"0",
"error_msg":
"",
"data":
{
"patient_id":
"07341271",
}
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- his 平台 接口