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

使用 Anpheros 构建

从访问到生产的九个步骤 — 身份验证、API、医疗数据、同意、FHIR、Webhook、SDK 和上线 — 每个步骤都有指南。

在 Anpheros 上进行开发意味着将其用作您应用程序的医疗数据层：您的产品调用 Anpheros API 来存储和读取 HL7 FHIR R4 格式的患者记录，获取患者同意，并接收事件。本页是从首次访问到生产的路线图；每个步骤都链接到详细介绍该步骤的指南。

1. 获取访问权限

Anpheros 平台目前处于私有 Beta 测试阶段。沙盒环境是自助服务的：在仪表板 (https://platform.anpheros.com/dashboard/) 上使用 Google 登录，然后点击“获取沙盒密钥”——您将获得一个组织、一个沙盒项目（包含 30 个合成患者）以及一个密钥。生产环境的访问需要申请 ([email protected])。您可以在仪表板或通过 Admin API 创建更多项目和 API 密钥；OAuth 应用程序在 POST /admin/projects/{id}/applications 注册，Webhook 在 POST /v1/webhooks 注册。

项目是隔离单元：其密钥只能访问它创建的患者（以及在获得同意的情况下，那些授予它访问权限的患者）。

2. 认证

凭证	用于	格式
API key	您的服务器	`sk_test_…` (sandbox), `sk_live_…` (production)
OAuth access token	代表一位患者的应用	`at_…`, 有效期 30 分钟, 使用轮换的刷新令牌刷新

将其作为 Authorization: Bearer <credential> 发送。密钥仅显示一次，绝不能出现在移动或 Web 应用中。→ 认证和 OAuth

3. 连接到 API

基础 URL 为 https://platform.anpheros.com；REST 接口为 /v1，FHIR R4 接口为 /fhir/R4。交互式参考文档和 OpenAPI 规范描述了每个端点。

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

→ API 参考 · Healthcare API

4. 创建和读取医疗数据

为您的每个用户创建一个患者，使用 Idempotency-Key 写入观察、诊断、用药和文档，并将它们作为列表或时间线读回。声明每次写入的作者（patient、practitioner、device、import、ai）。

→ 入门 · 医疗数据 API · 构建医疗应用

5. 添加同意

要访问某人在 Anpheros 中已有的记录，请使用其重定向 URI 注册一个 OAuth 应用程序，将用户引导至具有您所需范围的同意页面，然后用代码（PKCE）交换令牌。用户可以选择时长，并可以随时撤销访问权限；每一次读取操作都对用户可见。

→ 同意和访问模型 · 身份验证和 OAuth

6. 在需要完整模型时使用 FHIR

除了 REST API 之外，还可以通过 FHIR R4 使用其他资源类型 — 免疫接种、手术、护理计划、过敏、就诊等，共 26 种，同时支持搜索、历史记录、事务 $everything 和国际患者摘要 ($summary)。

→ FHIR 平台 · FHIR 代码系统 · 医疗数据互操作性

7. 响应事件

为 resource.*、consent.* 或 document.finalized 事件注册一个 webhook 端点，并验证每次传递的 Anpheros-Signature。实验室报告可以一次性发送到实验室连接器。

→ Webhooks · Lab connector · Healthcare integrations

8. 使用 SDK

@anpheros/sdk (TypeScript: Node 18+, 浏览器, Deno, Bun) 和 anpheros_sdk (Dart / Flutter) 覆盖了整个公共 API，具有相同的结构，为创建操作添加了幂等性键，支持在 429/5xx 上重试，并实现了令牌刷新和授权流程。

npm install @anpheros/sdk        # or: dart pub add anpheros_sdk

→ SDKs

9. 上线生产环境

生产环境密钥（sk_live_）将颁发给已签署数据处理协议的已验证组织。
请注意私有测试版的限制：单区域，无合同 SLA，每个密钥和每个 IP 每分钟 600 次请求。
按类型处理错误，并保留 Anpheros-Request-Id 以便支持。
查看数据如何受到保护以及存储位置。

→ 安全、隐私和数据驻留 · 限制 · 错误 · 版本控制和弃用

添加 AI

如果您的产品包含 AI 助手或代理，上下文 API 会在 token 限额内，并为模型使用的每个条目都标明来源，从而准备好记录的相关部分。→ AI 医疗应用