产品动态

产品简介

产品概述

产品优势

应用场景

购买指南

计费概述

购买方式

欠费、续费和退费说明

快速入门

PC 端

移动端

操作指南

注册与登录

远程诊断

远程会诊

远程查房

远程示教

数据统计

影像质控

平台管理

患者影像档案

API 文档

API 简介

更新动态

检查上云相关接口

互联网医院相关接口

错误码

常见问题

联系我们

检查上云相关接口

PDF

聚焦模式

字号

最后更新时间： 2025-03-07 17:07:30

本接口实现从院内已有第三方系统（例如 PACS、RIS）推送检查信息、报告、影像至前置机，并经由前置机上云存储。
鉴权方式
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 字段。
接口说明
触发时机：检查完成时，收到图像则上传检查信息。
传输协议：HTTPS POST
数据交互格式：JSON （Content-Type: application/json）
接口地址：地址：https://${host}/ris/study/add ，其中，host 为部署前置机 IP。
接口参数类型说明：
参数类型
类型说明
A
强制必填，缺失将报错并拒绝接收数据，造成业务无法正常使用
B
存在则必填，缺失仍然可正常接收数据，但会影响业务正常使用
C
非必填，缺失仍然可正常接收数据，但不会影响业务正常使用
请求参数
参数名
类型
是否必填
参数类型
备注
patientId
string
必填
A
患者 ID
patientName
string
必填
A
患者姓名
patientSex
string
必填
A
患者性别
M：男
F：女
O：其他
studyId
string
必填
A
检查 ID
accessNumber
string
必填
A
AccessNumber
modality
string
必填
A
设备类型
patientAge
string
必填
B
患者年龄
patientAgeUnit
string
必填
B
患者年龄单位，Y（岁），M（月），D（天）
patientBirthday
string
必填
B
患者生日，yyyy-MM-dd
size
string
必填
B
患者身高（m 单位米）
weight
string
必填
B
患者体重（kg 单位公斤）
phoneNum
string
必填
B
电话号码
medicalInsuranceNum
string
必填
B
医保号
idCardNum
string
必填
B
身份证号
hkAndMarcoPermitNum
string
必填
B
港澳通行证号
passportNum
string
必填
B
护照号
otherInfo
string
必填
B
其他身份信息
homeAddress
string
非必填
C
家庭住址
bodyPart
string
必填
B
检查部位
studyDesc
string
必填
B
检查描述
studyDate
string
必填
B
检查时间，yyyy-MM-dd hh:mm:ss
appointDate
string
非必填
C
预约时间
scanMode
string
必填
B
扫描方式
studyCategory
string
必填
B
检查类别
normal：平诊
emergency：急诊
applyDept
string
必填
B
申请科室
applyDoctor
string
必填
B
申请医生
applyDeptId
string
必填
B
申请科室 ID
applyDoctorId
string
必填
B
申请医生 ID
hisNum
string
必填
B
HIS 号
clinicNum
string
非必填
C
门诊号
inpatientNum
string
非必填
C
住院号
healthScreenNum
string
非必填
C
体检号
examDept
string
必填
B
检查科室
examDoctor
string
必填
B
检查医生
examDeptId
string
必填
B
检查科室 ID
examDoctorId
string
必填
B
检查医生 ID
examInfo
string
非必填
C
检查信息（曝光次数、检查费用）
inpatientWard
string
非必填
C
住院病区
bedNum
string
非必填
C
住院床号
diagnosis
string
非必填
C
临床诊断
symptom
string
非必填
C
临床症状
allergies
string
非必填
C
过敏反应
studyRequirement
string
非必填
C
检查需求
equipment
string
非必填
C
检查设备
status
string
必填
B
检查状态
registered：登记
partial：初诊
preliminary：审核
print：打印
final：最终状态
studyUid
string
必填
B
检查 Uid
imageCnt
int
必填
B
（数据对账）图片数
reportCnt
int
必填
B
（数据对账）结构化报告数
pdfCnt
int
必填
B
（数据对账） pdf 格式报告数
seriesCnt
int
必填
B
（数据对账）序列数
请求返回
字段
类型
备注
code
int
标注本次访问是否成功的错误码，0成功，非0失败
message
string
错误描述

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

数智医疗影像平台

检查上云相关接口

鉴权方式

接口说明

请求参数

请求返回

帮助和支持

参数类型	类型说明
A	强制必填，缺失将报错并拒绝接收数据，造成业务无法正常使用
B	存在则必填，缺失仍然可正常接收数据，但会影响业务正常使用
C	非必填，缺失仍然可正常接收数据，但不会影响业务正常使用

参数名	类型	是否必填	参数类型	备注
patientId	string	必填	A	患者 ID
patientName	string	必填	A	患者姓名
patientSex	string	必填	A	患者性别 M：男 F：女 O：其他
studyId	string	必填	A	检查 ID
accessNumber	string	必填	A	AccessNumber
modality	string	必填	A	设备类型
patientAge	string	必填	B	患者年龄
patientAgeUnit	string	必填	B	患者年龄单位，Y（岁），M（月），D（天）
patientBirthday	string	必填	B	患者生日，yyyy-MM-dd
size	string	必填	B	患者身高（m 单位米）
weight	string	必填	B	患者体重（kg 单位公斤）
phoneNum	string	必填	B	电话号码
medicalInsuranceNum	string	必填	B	医保号
idCardNum	string	必填	B	身份证号
hkAndMarcoPermitNum	string	必填	B	港澳通行证号
passportNum	string	必填	B	护照号
otherInfo	string	必填	B	其他身份信息
homeAddress	string	非必填	C	家庭住址
bodyPart	string	必填	B	检查部位
studyDesc	string	必填	B	检查描述
studyDate	string	必填	B	检查时间，yyyy-MM-dd hh:mm:ss
appointDate	string	非必填	C	预约时间
scanMode	string	必填	B	扫描方式
studyCategory	string	必填	B	检查类别 normal：平诊 emergency：急诊
applyDept	string	必填	B	申请科室
applyDoctor	string	必填	B	申请医生
applyDeptId	string	必填	B	申请科室 ID
applyDoctorId	string	必填	B	申请医生 ID
hisNum	string	必填	B	HIS 号
clinicNum	string	非必填	C	门诊号
inpatientNum	string	非必填	C	住院号
healthScreenNum	string	非必填	C	体检号
examDept	string	必填	B	检查科室
examDoctor	string	必填	B	检查医生
examDeptId	string	必填	B	检查科室 ID
examDoctorId	string	必填	B	检查医生 ID
examInfo	string	非必填	C	检查信息（曝光次数、检查费用）
inpatientWard	string	非必填	C	住院病区
bedNum	string	非必填	C	住院床号
diagnosis	string	非必填	C	临床诊断
symptom	string	非必填	C	临床症状
allergies	string	非必填	C	过敏反应
studyRequirement	string	非必填	C	检查需求
equipment	string	非必填	C	检查设备
status	string	必填	B	检查状态 registered：登记 partial：初诊 preliminary：审核 print：打印 final：最终状态
studyUid	string	必填	B	检查 Uid
imageCnt	int	必填	B	（数据对账）图片数
reportCnt	int	必填	B	（数据对账）结构化报告数
pdfCnt	int	必填	B	（数据对账） pdf 格式报告数
seriesCnt	int	必填	B	（数据对账）序列数

字段	类型	备注
code	int	标注本次访问是否成功的错误码，0成功，非0失败
message	string	错误描述