# EHR API 和医疗记录 API

> 应用如何通过 FHIR 读取和写入健康记录：医院 EHR API 与患者控制的记录 API，各自的覆盖范围，GDPR 和欧盟托管，以及 HIPAA（BAA 和美国地区可根据要求提供）。

Source: https://developers.anpheros.com/zh/guides/ehr-api

**EHR API（电子健康记录 API，也称为 EMR API 或医疗记录 API）允许软件通过互联网读取和写入患者的健康记录——人口统计信息、诊断、药物、过敏史、检查结果、文档——通常以 OAuth 保护下的 HL7 FHIR R4 资源形式呈现。** Epic 和 Oracle Health 等医院 EHR 供应商会公开其自身记录的 FHIR API，在美国，经过认证的 EHR 必须通过此类 API 提供患者访问权限。Anpheros 则是一个不同的组件：一个患者控制的医疗记录 API，任何应用都可以基于它进行构建，诊所、实验室、应用和设备将每个人的数据写入一个 FHIR R4 记录，并且访问需要获得该个人的同意。

<!-- visual:ehr-stack -->

## 两种医疗记录 API

| | 医院 EHR API (例如 Epic, Oracle Health) | 患者控制的记录 API (Anpheros) |
|---|---|---|
| 记录归属 | 单个医院或健康系统 | 一个人，来自所有写入该记录的来源 |
| 如何获取访问权限 | 通过供应商进行应用注册，通常每个健康系统都需要单独注册 | 自助服务沙盒密钥；生产环境需要数据处理协议 |
| 谁授权 | 健康系统，以及患者（针对患者访问应用） | 患者（OAuth 同意）或创建患者的组织 |
| 写入数据 | 有限，取决于供应商 | 创建、更新和删除自己的资源；每次写入都有溯源信息 |
| 标准 | FHIR R4 (在美国为 US Core) | FHIR R4 加上一个更简单的 REST API |
| 最适合 | 读取医院记录的内容 | 构建一个基于用户随身携带的记录的产品 |

它们协同工作：应用可以通过其 API 读取医院 EHR，并在 Anpheros 中维护个人的记录，将医院作为记录来源。

## Anpheros 记录 API 涵盖内容

| 记录部分 | FHIR 资源 | REST v1 |
|---|---|---|
| 人口统计信息 | `Patient` | `/v1/patients` |
| 诊断 | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| 药物 | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| 结果和生命体征 | `Observation` (LOINC) | `/v1/patients/{id}/observations`, 实验室导入 |
| 文档 | `DocumentReference` | `/v1/patients/{id}/documents` |
| 所有内容，按顺序 | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| 可共享的摘要 | `Patient/$summary` (IPS) | — |

```bash
# one patient's active problems, as FHIR
curl "https://platform.anpheros.com/fhir/R4/Condition?patient=$PID&clinical-status=active" \
  -H "Authorization: Bearer $KEY"
```

## 合规性与数据位置

- **GDPR 和欧盟：** 数据存储和处理于欧盟（Google Cloud `europe-west4`，荷兰）；每一次读写都会被记录并对患者可见；其他应用程序的访问需要患者的同意。
- **HIPAA：** Anpheros 作为美国诊所的业务伙伴（Business Associate）。业务伙伴协议（BAA）和美国数据区域可应生产客户的要求提供；在美国患者数据生产环境的开放需要先签署 BAA。在此之前，请勿在 Anpheros 中存储受 HIPAA 保护的健康信息。

## 常见问题解答

### 什么是 EHR API？
一种软件用于读取和写入电子健康记录的接口，通常是 HL7 FHIR R4 资源，如 Patient、Condition、MedicationStatement 和 Observation，并使用 OAuth 和 SMART on FHIR 进行授权。

### EHR API 和 EMR API 有什么区别？
在实践中，这两个术语可以互换使用。EMR 传统上指一个诊所的记录；EHR 指旨在跨提供者共享的记录。如今，两者通常都作为 FHIR API 公开。

### 我可以通过 Anpheros 访问医院的 EHR 吗？
不可以。Anpheros 本身不连接到医院 EHR。您的应用程序可以单独读取医院的 FHIR API，并将患者允许的内容存储在他们的 Anpheros 记录中。

### 有免费的医疗记录 API 供开发者使用吗？
是的。Anpheros 沙盒是免费的，提供 30 名合成患者，使用 FHIR R4 和 REST；生产环境起价为每月 49 欧元。

### Anpheros 符合 HIPAA 标准吗？
对于美国诊所，Anpheros 作为**业务伙伴 (Business Associate)**：生产客户可根据要求提供业务伙伴协议 (BAA) 和美国数据区域，以及书面的安全计划（风险分析、策略、审计日志、加密、备份）。在存储受保护的健康信息之前请告知：BAA 签署后生产环境即可启用。请参阅 [安全、隐私和数据驻留](https://developers.anpheros.com/zh/guides/security)。

<!-- visual:cta-ehr -->

## 相关资源

- [Healthcare API](https://developers.anpheros.com/zh/guides/healthcare-api)
- [Patient medical record](https://developers.anpheros.com/zh/guides/patient-medical-record)
- [Longitudinal patient data API](https://developers.anpheros.com/zh/guides/longitudinal-patient-data-api)
- [Patient consent platform for health apps](https://developers.anpheros.com/zh/guides/patient-consent-platform)
- [Security, privacy and data residency](https://developers.anpheros.com/zh/guides/security)
- [How to integrate clinic systems with a FHIR backend](https://developers.anpheros.com/zh/guides/integrate-clinic-systems-fhir)