医匠透析 PadOS 操作手册 · 开放接口概览
开放接口概览
HIS / LIS / PACS 检验与检查数据接入 HDIS 的方式、相关文档与凭据申请。
关于本页本页内容与《HDIS 开放接口对接规范》同步维护，规范版本 v1（草案） · 更新日期 2026-09-15。对接过程中有疑问请联系医匠透析项目组。
医院的检验结果与检查报告通过 HDIS 开放接口接入：由 HIS / LIS / PACS 厂商主动调用接口推送，HDIS 不接入医院内网，不访问院方数据库，不部署前置机。接入的数据用于系统内查阅，并作为质控上报的数据来源。
文档说明
| 文档 | 适用对象 | 内容 |
|---|---|---|
| 开放接口对接规范 | 医院信息科、HIS / LIS / PACS 厂商对接工程师 | 签名鉴权、推送接口、患者标识、返回码、联调步骤 |
| 标准检验项字典 | 配置项目映射时查阅 | 183 个标准检验、检查项目的编码、单位、别名与类型 |
字典以 GET /open/v1/dict/lab-items 的返回为准，字典页供人工查阅对照。接入方无需按字典改造 LIS，推送院内的 itemCode + itemName 即可。
对接方式
- 接入方主动推送。 HDIS 不接入医院内网，不访问接入方数据库，不部署前置机，也不要求接入方开放入站端口。报告审核发布后，由接入方系统发起 HTTPS 请求推送数据。
- 只推送报告，不推送影像。 检验报告推送原始检验值，检查报告推送报告文本和结构化测值；不接收 DICOM 图像与预览图，阅片通过接入方 PACS 自身的阅片入口进行。
- 派生指标由 HDIS 计算。 Kt/V、URR、nPCR、钙磷乘积等指标需要结合 HDIS 中的治疗数据计算，接入方无需提供。
基础地址
| 部署方式 | 基础地址 |
|---|---|
| 云端部署 | https://hdis.api.yijiangsoft.com/open/v1 |
| 院内离线部署 | 院内 HDIS 服务器地址，由医匠透析项目组另行通知 |
完整请求地址为基础地址加接口路径，如 GET https://hdis.api.yijiangsoft.com/open/v1/ping。全部接口的字段、请求示例见 Apifox 在线文档；也可下载 OpenAPI 文件，导入 Apifox、Postman 等工具使用。
申请凭据
接入申请通过后，HDIS 为每家医院分配凭据，凭据不得跨医院复用：
| 项 | 说明 |
|---|---|
appId | 应用标识，明文，随请求头发送；数据归属哪家医院由它决定 |
appSecret | 应用密钥，仅用于在接入方本地计算签名，不得出现在任何请求中 |
联调阶段使用沙箱凭据，可自由推送测试数据；联调通过后切换为生产凭据，两类凭据使用同一基础地址。
申请时请一并提供服务器出口 IP（可多个），用于配置 IP 白名单；出口 IP 变更前请提前告知，否则请求将被拒绝。取得凭据后，按对接规范第 8 节的联调步骤，从 GET /open/v1/ping 开始逐项联调，一般半个工作日可完成。
医匠透析 PadOS（HDIS）用户操作手册