北京市医疗服务与执业监管平台-互联网医院数据采集接口说明-V1.7-20210413.pdf

北京市医疗服务与执业监管平台

互联网医院数据采集接口说明

V1.7

服务基本地址

互联网医院若通过政务专网进行数据上传，采集接口的基本地址如下：

9:8083/hlwyy

互联网医院若采用互联网VPN进行数据上传，采集接口的基本地址如下：

:8081/hlwyy

接口说明

REST接口。医院调用程序在首次上传数据之前，需要“获取access_token”，

然后用这个access_token作为凭证进行诊疗数据上传。在access_token有效期

内多次上传数据，不必重新获取access_token。但当接口返回“授权过期”时，需

要重新“获取access_token”。

获取access_token

access_token是全局唯一的接口调用凭据，调用各接口时都需使用

access_token。互联网诊疗数据采集业务的access_token的有效期暂定为24个

小时。access_token到期之前不需要重新获取。

获取access_token需要调用者唯一凭证appid和密钥secret，这两个参数请

以本医疗机构账号登录北京市互联网医院接入平台查看。

1承建单位：北京东华万兴软件有限公司

https请求方式

HTTPMethodGET

URL

/auth/token?appid=APPIDsecret=APPSECRET

参数说明

参数必填说明

appid是接口调用者唯一凭证

secret是接口调用者唯一凭证密钥

返回说明

正常返回

Json数据包

{access_token:ACCESS_TOKEN,expires_in:3600}

数据说明

名称说明

access_token

获取到的凭证

expires_in

凭证有效时间，单位：秒

错误返回样例

Json数据

{errcode:1001,errmsg:不是有效的凭证或密钥}

数据说明

返回码返回信息

1001不是有效的凭证或密钥

2承建单位：北京东华万兴软件有限公司

诊疗数据上传

根据互联网医院类型不同，分为西医类互联网医院和中医类互联网医院。二者采集

数据项、使用的数据字典均有所区别，请参看接口文档中相对应的接口标准和XML样

例。上传接口的URL也不相同，特别提醒注意。

https请求方式

HTTPMethodPOST

Content-Typetext/xml

URL

西医类互联网医院：

/ihosp/clinic?access_token=ACCESS_TOKEN

中医类互联网医院：

/ihosp/tcm?access_token=ACCESS_TOKEN

Body数据

Xml格式诊疗数据（