# 医疗保健集成

> 今日支持的集成模式：一次调用中的实验室报告、代表组织进行写入的诊所、设备、已授权的第三方应用程序、Webhooks 和 SDK — 以及当前不可用的功能。

Source: https://developers.anpheros.com/zh/guides/healthcare-integrations

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

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

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

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

```bash
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 行；每个结果都带有来源信息，指明源系统和报告。

详情：[实验室连接器](https://developers.anpheros.com/zh/guides/lab-connector)。

## 诊所：代表组织进行写入

诊所及其工作人员是目录资源 (`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 后端集成](https://developers.anpheros.com/zh/guides/integrate-clinic-systems-fhir)。

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

## 设备和可穿戴设备

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

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

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

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

[身份验证和 OAuth](https://developers.anpheros.com/zh/guides/authentication)

## 事件：响应变更

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

## SDK

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

## 不可用功能

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

## 相关

- [如何将诊所系统集成到 FHIR 后端](https://developers.anpheros.com/zh/guides/integrate-clinic-systems-fhir)：诊所 EMR 的分步教程
- [如何规范化医疗数据](https://developers.anpheros.com/zh/guides/normalize-medical-data)：代码、单位、日期、重复项、验证
- [如何将实验室结果导入 FHIR 记录](https://developers.anpheros.com/zh/guides/import-lab-results-fhir)：使用 CSV 和 HL7 v2 的分步教程
- [医疗数据互操作性](https://developers.anpheros.com/zh/guides/interoperability)
- [医疗 API](https://developers.anpheros.com/zh/guides/healthcare-api)
- [架构](https://developers.anpheros.com/zh/guides/architecture)
- [用例](https://developers.anpheros.com/zh/guides/use-cases)