Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

医疗保健集成

当前支持的集成模式：一次调用获取实验室报告，诊所代表组织写入数据，设备，已授权的第三方应用程序，Webhooks 和 SDK——以及当前不支持的功能。

医疗保健集成将生成或需要健康数据的系统 — 实验室、诊所、设备、其他应用程序 — 连接到患者的记录。 通过 Anpheros，每次集成都通过相同的 API 和相同的规则进行：数据以 HL7 FHIR R4 格式写入，归因于其来源，对患者可见，并且仅在获得患者同意的情况下与第三方共享。本页介绍平台今日支持的集成模式。

探索 Anpheros 集成目录，查看每个集成的验证状态（可用、Beta 版或开发者指南）、它交换的数据和 FHIR 资源、其方向、身份验证和文档。

实验室：一次调用获取完整报告

实验室或任何存储实验室报告的系统，发送一份完整报告，平台会将每个结果转换为一个实验室 Observation：

curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv

格式：CSV（罗马尼亚语或英语标题，接受小数点逗号）、HL7 v2 ORU^R01 和 JSON。
当报告提供代码或名称与平台术语匹配时，标记将映射到 LOINC；其他标记保留实验室自己的代码并列为 unmapped。
每行都会获得一个稳定的标识符，因此重新发送同一份报告将跳过已导入的内容。
每个请求最多 500 行；每个结果都带有来源信息，指明源系统和报告。

详情：实验室连接器。

诊所：代表组织进行写入

诊所及其工作人员是目录资源 (Organization, Practitioner, PractitionerRole)。诊所系统随后可以说明每个请求的背后是谁：

X-Anpheros-Acting-As: PractitionerRole/<id> — 通过您的应用程序工作的执业医师；写入访问日志并以姓名显示给患者；
X-Anpheros-On-Behalf-Of: Organization/<id> — 进行写入操作的组织；
X-Anpheros-Author-Ref: Practitioner/<id> — 在 Provenance 中记录的作者。

在获得患者同意后，诊所可以读取整个记录，包括其他组织写入的内容，并且只更改自己写入的内容。可以使用 FHIR transaction bundle (POST /fhir/R4) 原子地写入多个资源。

一个工作示例，从目录到作为一次事务写入的就诊：如何将诊所系统与 FHIR 后端集成。

已通过一个测试诊所项目端到端地实现了“同意 → 由诊所项目写入的实验室 Observation → 患者应用程序中的通知”流程。

设备和可穿戴设备

来自设备的测量值是 Observations，包含 author_type: "device" 和一个 LOINC 代码 — 心率、血压、SpO₂、体重、血糖、步数、睡眠时长等（FHIR 代码系统）。Anpheros Daily 以相同的方式将从 Apple Health 和 Health Connect 读取的每日摘要写入 Observations。Anpheros 不直接连接到设备供应商的云端；您的应用程序或后端读取设备数据并写入结果。如何读取 Apple Health、Health Connect 和 Samsung Health 并将每个指标映射到 LOINC：FHIR 中的可穿戴设备数据。

第三方应用程序：授权访问

希望访问用户在 Anpheros 中存储的数据的应用程序，需要进行一次注册，并通过 OAuth 2.1 with PKCE（SMART on FHIR 独立启动）流程请求授权：

GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access — 托管的授权页面；
用户选择记录和时长（30、90、180 或 365 天）；
POST /oauth/token 使用授权码兑换访问令牌（30 分钟）和轮换刷新令牌（30 天）；
应用程序只能看到该患者的数据，并且仅限于其授权范围，使用其自身的成对 ID。

身份验证和 OAuth

事件：响应变更

与其轮询，不如注册一个 webhook。交付会使用 HMAC-SHA256 进行签名，并以指数退避（backoff）重试长达 24 小时，并且携带 ID，绝不包含临床内容。当另一个项目写入您有权访问的记录时，事件会告知您（data.external: true，附带来源）。Webhooks

SDK

TypeScript (@anpheros/sdk) 和 Dart / Flutter (anpheros_sdk) SDK 实现了上述所有功能 — 实验室导入 (labs.importCsv, labs.importHl7, labs.importItems)、带 PKCE 的 OAuth、Webhook 管理和签名验证。SDK

不可用功能

针对特定医院 EHR 或实验室信息系统的现成连接器；集成是基于 API 构建的。
SMART EHR 启动（在 EHR 内部启动）；仅支持独立启动。
直接的设备供应商集成。