API 接口参考

MedGroup 在线 API 能力概览、最小联调流程与示例

API 接口参考

这是什么

MedGroup 在线平台提供标准 HTTP/JSON 接口,可用于 DRG/DIP 单条分组、编码查询、结算模拟、配额查询等场景。

如果你当前只是做能力验证、产品演示或轻量接入,这一页先给你「能不能接、怎么最快跑通」的概览。完整的参数说明、鉴权约定和字段级响应文档,请联系团队获取。

部署架构

┌──────────────┐ HTTPS (JSON) ┌────────────────────────────┐
│ 调用方系统   │ ◄──────────► │ MedGroup 在线 API 平台     │
│ HIS / BI / 中台 │            │ medgroup.medchat.fun       │
└──────────────┘              └────────────────────────────┘
  • 运行方式:MedGroup 在线统一托管
  • 协议:HTTPS,JSON 格式
  • 适合场景:快速验证、演示接入、轻量级系统集成

最小联调流程

  1. 确认目标能力:明确要验证的是单条分组、编码查询、结算模拟还是配额能力
  2. 单条验证:优先调通 drg-groupingdip-grouping,确认请求结构与返回结果
  3. 异常与权限:补测参数异常、无权限、配额不足等边界情况
  4. 业务接入:再扩展到批量处理、报告生成或前端工作台等上层流程

接口能力概览

统一响应格式

{ "code": 0, "message": "ok", "data": { ... } }
  • code:0 表示成功,非 0 表示失败
  • message:状态描述
  • data:业务数据

核心接口

/api/drgdip/search-icd
/api/drgdip/drg-grouping
/api/drgdip/dip-grouping
/api/drgdip/calculate-settlement
/api/quota

单条分组请求示例

{
  "selectedCity": { "value": "全国版", "label": "全国版" },
  "pdxCode": { "code": "J18.900", "name": "肺炎" },
  "adxCodes": [],
  "procCodes": [],
  "gender": "女",
  "age": 45,
  "los": 7,
  "icu": "否"
}

适用场景

  • 业务系统需要快速补齐 DRG/DIP 单条分组能力
  • 需要做编码查询、结算模拟或规则验证的轻量接入
  • 做产品演示、POC 或投标沟通时,希望先跑通标准接口
  • 已在使用 MedGroup 前台能力,希望继续接入自有系统

常见问题

更适合在线 API 还是本地部署?

如果你希望快速验证与轻量接入,优先使用在线 API。若更关注院内部署、数据闭环和私有化交付,可再评估本地化部署方案。

联调时最先验证什么?

通常先验证 3 类内容:单条分组是否正确、异常输入是否可控、关键接口的响应速度是否满足业务流程。

需要改动很多现有系统吗?

通常不需要。大多数场景通过标准 HTTP/JSON 接口调用即可,调用方只需完成字段映射和结果展示。

如何获取完整接口文档?

完整的 API 参数文档、鉴权方式、字段级响应示例和测试约定,请联系团队获取正式对接资料或演示环境。

API 工作台

当前文档页只保留概览级说明。如果你需要在线查看真实请求与响应,建议联系团队开通测试环境或演示账号。