医疗数据 API：如何选择、读写患者记录，一小时搞定

“医疗保健 API”涵盖了非常多的内容：医院的 HL7 v2 数据流、国家电子处方服务、可穿戴设备供应商的导出功能、FHIR 服务器。如果您正在构建健康应用程序、诊所工具或人工智能助手，您需要的范围会更窄：一个以标准格式存储患者记录的后端，允许患者决定谁可以读取这些记录，并为您提供一个干净的 API 接口。本指南将说明需要关注哪些方面，并通过实际的 API 调用展示 Anpheros 平台在最初一小时内的使用情况。

面向开发者的技术版本： 医疗保健 API · 医疗数据 API 在 developers.anpheros.com 上，包含请求、响应和限制。本页面为通俗易懂的版本。

医疗保健数据 API 需要具备的功能

有五点区分了一个可用的健康数据 API 和一个带有 HTTP 前缀的数据库。

• 标准格式。 HL7 FHIR R4 是医院、国家系统和欧盟健康数据空间使用的格式。以 FHIR 格式存储的记录可以被其他系统读取，无需自定义桥接。专有 JSON 格式则不行。
• 患者同意作为一等公民。 谁可以读取什么内容、读取多久、是否可撤销、患者是否可见。而不是您自己数据库中的一个复选框。
• 溯源性。 每一条数据都标明了是谁写入的：患者、医护人员、设备、导入数据、计算得出的结果。一个无法区分实验室结果和患者自行猜测的人工智能助手是危险的。
• 带有真实数据的沙盒环境。 您不能用真实患者进行测试，也不应该自己创建 30 个具有六个月历史记录的合成患者。
• 可指定的数据驻留地。 对于欧洲用户来说，这意味着服务器位于欧盟境内，符合 GDPR 法规，并有数据处理协议。

两种接入方式：REST 和 FHIR，数据相同

Anpheros 平台以两种方式暴露相同的记录。一种是简单的 REST API (/v1)，用于产品代码；另一种是严格的 FHIR R4 (/fhir/R4)，用于需要与健康系统其他部分交互的任何内容。ID 在两者中是相同的；每个 v1 对象都带有其 fhir 引用。

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# 您项目可见的患者
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# 实验室结果，最新在前
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# 活动中的药物
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# 时间线上的所有内容
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# 相同的数据，严格的 FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

这些 API 调用背后是 26 种 FHIR 资源类型（Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance 等），使用 LOINC 编码测量值，ICD-10 编码病情，ATC 编码药物。

获取密钥只需一分钟

沙盒环境是自助服务且免费的。登录 platform.anpheros.com/dashboard，点击获取沙盒密钥，您将获得一个组织、一个沙盒项目和一个 sk_test_… 密钥。该项目自带 30 名合成患者的副本：来自欧盟各地的成年人、儿童和老年人，他们有病情、药物、过敏史、实验室结果和六个月的生命体征数据。您可以修改或删除任何内容；重置后它们会恢复原样。

生产密钥 (sk_live_…) 将提供给经过验证的组织，并签订数据处理协议。沙盒和生产环境是不同的数据库：沙盒密钥在物理上无法访问真实患者。

其他功能

• OAuth 2.1 with PKCE 和 SMART on FHIR 独立启动，以便应用程序可以请求用户授权访问其自己的记录。
• 带有范围、有效期和撤销功能的同意管理，以及患者可以查看的访问日志。
• 签名 Webhook (HMAC-SHA256，带有指数退避重试) 用于 resource.created、consent.granted、consent.revoked、document.finalized 事件。
• AI 上下文 API，可在令牌预算内构建带有溯源标签的患者摘要。
• 实验室报告导入，支持 CSV、HL7 v2 ORU^R01 或 JSON 格式，并映射到 LOINC。
• 国际患者摘要 ($summary) 和 SMART Health Links，可通过 QR 码共享。
• Dart 和 TypeScript 的 SDK，/docs 处的 OpenAPI 参考，以及 /fhir/R4/metadata 处的 CapabilityStatement。

完整的操作指南，包含响应示例，请访问 developers.anpheros.com/guides/first-hour。

常见问题

今天我能免费开始使用一个医疗保健 API 吗？

是的。Anpheros 沙盒是免费且自助服务的：登录、获取密钥，您将拥有 30 名合成患者供您读取和写入。每个项目的限制是每天 10,000 次资源写入，您自己的患者数量上限为 100 名，文档存储上限为 250 MB。

REST 还是 FHIR，我应该使用哪个？

对于您自己的产品代码，请使用 /v1：它更简单，并返回纯 JSON。当其他系统需要读取数据时，当您需要 FHIR 搜索、_history、$everything 或 $summary 功能时，或者当认证要求时，请使用 /fhir/R4。两者都可以访问相同的记录。

患者同意是如何处理的？

个人通过 OAuth 向应用程序授予访问其记录的权限，选择范围和时长（30、90、180 或 365 天）。该授权可以随时撤销，并且患者可以看到访问日志中的每一次读取操作。详情请参阅 同意模型。

数据托管在哪里？

在欧洲联盟（Cloud Run, europe-west4），每次写入都带有溯源和版本历史记录。生产环境使用需要签订数据处理协议。

生产环境的费用是多少？

生产环境起价为每月 49 欧元，可存储 2,500 名患者，首月免费；更高级的套餐为每月 199 欧元和 799 欧元。沙盒环境保持免费。请参阅 定价。

它能与 AI 代理一起使用吗？

是的。有一个带有溯源标签和令牌预算的 AI 上下文 API，以及一个位于 platform.anpheros.com/mcp 的 MCP 服务器，任何支持 MCP 的助手都可以连接到它。请参阅 EMR 与 AI 医疗助手集成。