tencent cloud

检查上云相关接口
下载PDF
最后更新时间：2025-03-07 17:07:30
检查上云相关接口
最后更新时间： 2025-03-07 17:07:30
下载PDF
本接口实现从院内已有第三方系统（例如 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
错误描述
本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈