互联网医院相关接口

最近更新时间:2023-07-25 09:40:04

我的收藏

概述

数智医疗影像平台提供与互联网医院进行集成,实现用户在互联网医院进行检查、报告、影像的信息同步和业务交互。

参数说明

HTTP 接口通用签名,用如下的签名算法:
${signature} = Hmac-Sha256(${token}, ${appId}+${timestamp})
参数说明:
token - 密钥,由腾讯系统分配
appId - 合作方ID,由腾讯系统分配
timestamp - 时间戳,当前生成的时间戳,毫秒数
signature - 生成的密钥签名
所有接口在请求鉴权需要在 http 请求 header 头里面带上相应信息:
signature 对应 http 协议 header 的 signature 字段
appId 对应 http协议 header 的 appId 字段
timestamp 对应 http 协议 header 的 timestamp 字段

检查列表查询 API

使用场景:患者查询在院内完成的检查信息(根据请求参数数据用途 usage 字段来区分具体使用场景)
协议:HTTPS
地址:https://pacs.qq.com/thirdparty/patientStudies/${appId}
数据交互格式 :JSON (application/json)
使用流程: - 患者检查列表查询 - 会诊拉取患者检查信息 - 选择添加检查信息的候选列表,根据请求参数数据用途(usage)字段来区分具体使用场景
请求参数:
参数名
类型
是否必填
备注
phoneNum
string
患者电话号码,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
idNum
string
患者身份证号,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
hisId
string
医院信息系统 ID, HIS 号,如果有则填写
patientName
string
患者姓名
hospitalId
string
医院 ID(腾讯觅影影像云系统医院 ID)
unionId
string
医联体 ID(腾讯觅影影像云系统医联体 ID)
studyType
int
检查类型,
0:放射
1:眼科
2:病理
3:内镜
4:心电
5:超声
dataFlag
int
数据标识,
0:展示该患者全部的数据
1:仅展示本院来源的数据(根据医院ID)
2:展示除本院以外的数据(根据医院ID)
3:仅展示当前医联体来源的数据(根据医联体ID)
4:展示除当前医联体以外的数据(根据医联体ID)
usage
int
数据用途,
0:患者查看检查列表
1:患者在线咨询场景
2:医生查看患者详情
studyDateBegin
string
检查时间查询开始时间,yyyy-MM-dd hh:mm:ss
studyDateEnd
string
检查时间查询结束时间,yyyy-MM-dd hh:mm:ss
请求返回:
字段
类型
备注
code
int
标注本次访问是否成功的错误码,0成功,非0失败
message
string
错误描述
data
list(Study)
数据详情,JSON 列表
检查数据格式:
字段
类型
备注
hisId
string
医院信息系统 ID, HIS 号
reportId
string
影像云返回 reportId
studyType
int
检查类型,
0:放射
1:眼科
2:病理
3:内镜
4:心电
5:超声
studyDate
string
检查时间,yyyy-MM-dd hh:mm:ss
studyId
string
检查号,检查 ID
bodyPart
string
检查部位
studyName
string
检查项目
applyDoctor
string
申请医生
applyDoctorId
string
申请医生 ID
applyDept
string
申请科室
applyDeptId
string
申请科室 ID
uniAppId
string
跳转小程序 appid
uniPath
string
检查详情,小程序跳转路径带参数
h5Url
string
检查报告详情, h5跳转 URL
h5DetailUrl
string
检查影像详情, h5跳转 URL

会诊记录查询 API

使用场景:医生查询远程会诊记录
协议:HTTPS
地址:https://pacs.qq.com/thirdparty/patientConsultations/${appId}
数据交互格式 :JSON (application/json)
请求参数:
参数名
类型
是否必填
备注
hisId
string
医院信息系统 ID, HIS 号
phoneNum
string
患者电话号码,算法(AES-256-ECB + HEX)来加密字段, 密钥与签名 token 相同(32位)
idNum
string
患者身份证号,算法(AES-256-ECB + HEX)来加密字段, 密钥与签名 token 相同(32位)
patientName
string
患者姓名
hospitalId
string
医院 ID(腾讯觅影影像云系统医院 ID)
unionId
string
医联体 ID(腾讯觅影影像云系统医联体 ID)
请求返回:
字段
类型
备注
code
int
标注本次访问是否成功的错误码,0成功,非0失败
message
string
错误描述
data
struct
数据详情
数据格式:
字段
类型
备注
h5Url
string
患者的会诊列表,h5跳转 URL

检查报告 URL 获取 API

协议:HTTPS
地址:https://pacs.qq.com/thirdparty/patientReportUrl/${appId}
数据交互格式 :JSON (application/json)
使用流程:在影像云跳转第三方小程序后,通过 reportId 获取影像云报告 url
请求参数:
参数名
类型
是否必填
备注
reportId
string
影像云返回 reportId
phoneNum
string
患者电话号码,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
idNum
string
患者身份证号,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
hospitalId
string
医院 ID(腾讯觅影影像云系统医院 ID)
请求返回:
字段
类型
备注
code
int
标注本次访问是否成功的错误码,0成功,非0失败
message
string
错误描述
data
PatientStudyUrl
数据详情, JSON 对象
PatientStudyUrl 数据格式:
字段
类型
备注
h5Url
string
检查报告详情, h5跳转 URL
h5DetailUrl
string
检查影像详情, h5跳转 URL
studyId
string
检查号,检查 ID,与医院系统对齐

检查状态同步回调 API

使用场景:在云平台获取收到影像检查信息、报告信息和图片信息时,会回调合作方的接口,以同步影像云状态信息,方便公众号推送模板消息
协议: HTTPS
地址: 合作方定义
数据交互格式 :JSON (application/json)
请求参数:
参数名
类型
是否必填
备注
status
int
0:仅获取到检查信息
1:已获取到报告
2:已获取到图片
3:已获取报告和图片
phoneNum
string
患者电话号码,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
idNum
string
患者身份证号,算法(AES-256-ECB + HEX)来加密字段,密钥与签名 token 相同(32位)
patientId
string
患者 ID
hospitalId
string
医院 ID(腾讯觅影影像云系统医院 ID)
hisId
string
医院信息系统 ID, HIS 号,如果有则填写
studyType
int
检查类型,
0:放射
1:眼科
2:病理
3:内镜
4:心电
5:超声
studyDate
string
检查时间,yyyy-MM-dd hh:mm:ss
studyId
string
检查号,检查 ID
bodyPart
string
检查部位,如果有则填写
studyName
string
检查项目,如果有则填写
h5Url
string
检查报告详情, h5跳转 URL
h5DetailUrl
string
检查影像详情, h5跳转 URL
reportId
string
返回的 reportId,用于患者检查报告 URL 获取
请求返回:
字段
类型
备注
code
int
是否成功接收请求,0成功,非0失败
message
string
错误描述