互联网医院相关接口
最后更新时间：2025-03-07 17:07:30
概述
数智医疗影像平台提供与互联网医院进行集成，实现用户在互联网医院进行检查、报告、影像的信息同步和业务交互。
参数说明
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 | 错误描述 |
文档反馈