腾讯云数智医疗影像平台检查上云相关接口-医疗服务解决方案
概述
数智医疗影像平台提供与第三方系统(例如 PACS、RIS)进行对接,从而实现将院内第三方系统的检查信息、影像信息同步到云平台。文本提供的 API 仅适用于前置服务私有化部署时调用使用。
参数说明
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 字段接口参数类型说明:
参数类型 | 类型说明 |
A | 强制必填,缺失将报错并拒绝接收数据,造成业务无法正常使用 |
B | 存在则必填,缺失仍然可正常接收数据,但会影响业务正常使用 |
C | 非必填,缺失仍然可正常接收数据,但不会影响业务正常使用 |
检查信息上传API
触发时机:检查完成时,收到图像则上传检查信息传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/study/add (host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
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 | 错误描述 |
检查报告上传API
触发时机:检查完成报告审核后,上传报告信息传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/report/add(host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
reportNumber | string | 必填 | A | 报告号 |
studyId | string | 必填 | A | 检查 ID |
accessNumber | string | 必填 | A | 检查 AccessNumber |
imageDescription | string | 必填 | A | 影像描述 |
conclusion | string | 必填 | A | 诊断结论 |
reportTime | string | 必填 | B | 初诊时间,yyyy-MM-dd hh:mm:ss |
reportDoctor | string | 必填 | B | 初诊医生 |
auditTime | string | 必填 | B | 审核时间,yyyy-MM-dd hh:mm:ss |
auditDoctor | string | 必填 | B | 审核医生 |
printTime | string | 必填 | B | 打印时间,yyyy-MM-dd hh:mm:ss |
printDoctor | string | 必填 | B | 打印医生 |
请求返回:
字段 | 类型 | 备注 |
code | int | 标注本次访问是否成功的错误码,0成功,非0失败 |
message | string | 错误描述 |
云检查二维码返回API
触发时机:获取二维码,并放到患者登记时打印给患者的检查卡传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/getStudyQR(host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
studyId | string | 必填 | A | 检查 ID |
accessNumber | string | 必填 | B | 检查 AccessNumber |
patientId | string | 必填 | B | 患者 ID |
请求返回:
字段 | 类型 | 备注 |
code | int | 标注本次访问是否成功的错误码,0成功,非0失败 |
message | string | 错误描述 |
data | struct | 数据详情 |
数据格式:
字段 | 类型 | 备注 |
qrImage | string | 二维码图片 Base64 字符串 |
qrUrl | string | 云胶片二维码地址(外网),该字段为预留字段,暂时为空 |
结果示例:
{ "code":0, "message":"成功", "data":{ "qrImage":"iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAADZ0lEQVR42uyYPY68OhDECxE47Bvgi4zgWgRIWCLgWozmIuYGDh0g11M387GbveC/rIN1sGK8vwDc7urqxt/6W/96DSQfZJ6LT+Owk8cQ09juJEs1QA+4DeKWDQzwCfM9cuWe7F8XAZ7rBskzY3KHT1wKGIY98agLeOx0yxPI7T1ivDWXA0UY9IFM5D0yoDIAcI8oGT2EW6NR9pjPh6sAu/Z7ylPvZf3y8D0vfhnQ1e7ME2Av71i8rIzfROSHgR6ykmQYopBM7hjIc6evBhiI8QZxoaGobqiIcT28ytpVADzJKG65RwPcQia0pAuoBugh+eZ1XwU2wh09mG+fr7gC8Jgfe2KA6icTYGGNyK8rVwEADwwFXDZgPho66udsTbKda4AmyvqI4oIdaUN3NBbN5A7UAzCNtw6Y4BnaAs1NyUMUzNtVAFTbPTEzMrTRACO/RPPXgYbM+ifokW52kkr55J4idgEAM1rI6q/yDQJ1fbrzimYNQO9FD1BzU9YH6Za7JijEitQ1AJDc0dnPU1HDGU0ht2qAITLoAQJewrDT8X7awle4LwB6b7JpsuBI5qmJadaHt9L+PtBoSpoRpeUFDz1bRvC4DFAPoxWH2+nxnPqH3KqRqAl4alcTzTbbvVsfEdrsXATYbd+pPSBmtS/znadXfgvI7wMD04gOagIloBMuxQu3Dq+SdAUQuVrnfqeEW6c12tsOP8lbA5BVN46Gup80N7lu3bssXgOQRRyLpeTZwushvtS+BqBHwlDErtx43jSf9Js+vvrHAW1tNp/yBJ/0Fybts7ZOXp17DUAPOYugNaq0RkzWR8GXbvGnAZw9slWc+Xhe+zyUj8mpALC2S5WsQLLa5qVAws0T03WAT7P5K73tVEClQSvOa7pYAXAKLDQlZWURTJqtm7f28CKgiZiPTmPn09gWnOMFFfqpIoBJvyS3d2JEQ7cUn0YTkf4qYKDNinO7qevTsBbYBPvtiisAnlM1BrWm1ogNEeYGl8sAmy4WsXm+U7MX4DG2++dOVgDY5L875wzmBsNwusFPzfp54JxXu2Cuj9SG1KaLGX1VwOYTph4Y4ZknDffWmeReCXSiamA1Wl9S+2hBWxFg4Rb1fsxQUrP1wNs2XwCcg30LpE0+rc/Shiu3pRrgb/2t/7/+CwAA//+Q7bUC9L1DBAAAAABJRU5ErkJggg==", "qrUrl":"" }}
DICOM 影像上传 API
触发时机:该检查完成,pacs 获得图像后即上传图像协议:dicom c-store配置: 在PACS上配置觅影云网关的AEtitle IP Port,在觅影云网关配置 PACS 的 AETitle IP Port
标记删除检查 API
触发时机:当医院想要删除不显示一些错误的检查时,调用该接口传输检查信息,标记删除影像云上该检查记录传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/study/delete(host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
patientId | string | 必填 | A | 待删除 患者 ID |
studyId | string | 必填 | A | 待删除 检查 ID |
accessNumber | string | 必填 | A | 待删除 检查 AccessNumber |
studyUid | string | 必填 | A | 待删除 检查 Uid |
请求返回:
字段 | 类型 | 备注 |
code | int | 标注本次访问是否成功的错误码,0成功,非0失败 |
message | string | 错误描述 |
检查上传对账API
触发时机:定时上报已传检查维度数据以便核验数据的正确性传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/reconcilelog(host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
studyId | string | 必填 | A | 检查 ID |
accessNumber | string | 必填 | A | 检查 AccessNumber |
patientName | string | 必填 | A | 患者姓名 |
studyUid | string | 必填 | A | 检查 Uid |
studyDate | string | 必填 | A | 检查时间,yyyy-MM-dd hh:mm:ss |
reportCnt | int | 必填 | A | 结构化报告数 |
pdfCnt | int | 必填 | A | pdf 格式报告数 |
seriesCnt | int | 必填 | A | 序列数 |
imageCnt | int | 必填 | A | 图片数 |
请求返回:
字段 | 类型 | 备注 |
code | int | 标注本次访问是否成功的错误码,0成功,非0失败 |
message | string | 错误描述 |
检查相关ID上报API
触发时机:每天在闲时统一上报一个时间周期内已传检查相关 ID 列表数据传输协议 :HTTPS POST数据交互格式 :JSON (Content-Type: application/json)接口地址:https://${host}/ris/reconcilerangelog(host 为部署前置机 IP)请求参数:
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
startTime | string | 必填 | A | 对账时间段开始时间,yyyy-MM-dd hh:mm:ss |
endTime | string | 必填 | A | 对账时间段结束时间,yyyy-MM-dd hh:mm:ss |
studyList | Array(StudyLog) | 必填 | A | 检查相关 ID 的数据组 |
studyList数组里面StudyLog的结构
参数名 | 类型 | 是否必填 | 参数类型 | 备注 |
studyId | string | 必填 | A | 检查 ID |
accessNumber | string | 必填 | A | 检查 AccessNumber |
studyUid | string | 必填 | A | 检查 Uid |
studyDate | string | 必填 | A | 检查时间,yyyy-MM-dd hh:mm:ss |
reportCnt | int | 必填 | A | 结构化报告数 |
pdfCnt | int | 必填 | A | pdf 格式报告数 |
seriesCnt | int | 必填 | A | 序列数 |
imageCnt | int | 必填 | A | 图片数 |
请求返回:
字段 | 类型 | 备注 |
code | int | 标注本次访问是否成功的错误码,0成功,非0失败 |
message | string | 错误描述 |
腾讯云官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
发表评论