对接

先看资产,再做接口对接。

先确认可交付格式、样例输出和授权边界,真实接口对接按正式流程走。

交接工具包

三类资产在使用真实数据前展示交接方式。

OpenAPI schema

在交换凭证前,先查看接诊前入口、病历包分享、回调和导出路由。

Postman 起步集合

运行登录、公开接诊前入口、安全分享、医院回调和导出示例的主要请求。

示例 payload

查看示例回调、病例摘要元数据和 FHIR 导出,确认下游会收到什么。

覆盖范围

这些资产回答三个实际问题。

用它们确认请求如何收集、病历包如何准备、完成的记录如何到达团队。

公开接诊前入口

通过受控公开表单收集团队咨询和数据请求。

POST /api/v1/public/partner-leads
POST /api/v1/public/compliance-requests

病历包准备

支持登录、账号恢复、关键病例编辑,以及交接前的最终病历包批准。

POST /api/v1/auth/login
POST /api/v1/auth/password-reset/request
POST /api/v1/auth/password-reset/confirm
POST /api/v1/orders
POST /api/v1/orders/{order_id}/files
GET /api/v1/orders/{order_id}/patient-review
PATCH /api/v1/orders/{order_id}/patient-review

医院交接

创建上传邀请,在明确授权后发放到期分享链接,发送回调,并导出准备好的病例数据。

POST /api/v1/hospital/trigger-upload
POST /api/v1/orders/{order_id}/share
POST /api/v1/hospital/orders/{order_id}/dispatch-webhook
GET /api/v1/hospital/orders/{order_id}/fhir-bundle

可以检查什么

真实连接开始前,先审阅准确输出。

公开 schema、集合和示例足以先审阅它是否符合接诊、安全和医院或接诊的医生预期,再发放真实凭证。

访问按路由分开,患者动作、病历包准备和医院交接不共用同一凭证路径。

起步集合包含账号恢复请求,方便团队在上线前测试常见访问问题。

公开表单会创建跟进记录,而不是松散邮件线程,方便请求进入下一步动作。

医院交接目前聚焦于你决定给谁看授权后的安全分享 URL 和紧凑 FHIR bundle。

示例

真实凭证发放前,先检查示例 payload。

上传邀请 webhook

展示患者被邀请上传记录时医院会收到什么。

打开 JSON

病历包已分享 webhook

展示准备好的病历包获批安全分享后发送的回调。

打开 JSON

沙盒摘要

展示可复用病例元数据,包括订单 ID、URL 和交付状态字段。

打开 JSON

当前可用

足以判断下一步对接。

基础域名见公开配置

静态 schema:`/openapi/meddossier-openapi.json`

集合:`/meddossier-postman-collection.json`

示例:`/integration-examples/*`

上线前

正式上线前需要医疗团队直接确认。

真实端点凭证、回调确认规则和医院或接诊医生侧负责人。
生产 SSO、SDK 要求或客户特定 API 合同语言。
超过网站标准控制的 SLA、保留期和合规条款。