# 使用 Anpheros 进行开发

> 从访问到生产的九个步骤 — 认证、API、医疗数据、同意、FHIR、Webhooks、SDK 和上线 — 每个步骤都有相应的指南。

Source: https://developers.anpheros.com/zh/guides/build-with-anpheros

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

## 1. 获取访问权限

Anpheros 平台目前处于私有 Beta 测试阶段。沙盒环境是自助服务的：在仪表板 (`https://platform.anpheros.com/dashboard/`) 上使用 Google 登录，然后点击“获取沙盒密钥”——您将获得一个组织、一个沙盒项目（包含 30 个合成患者）以及一个密钥。生产环境的访问需要申请 (`contact@anpheros.com`)。您可以在仪表板或通过 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](https://developers.anpheros.com/zh/guides/authentication)

## 3. 连接到 API

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

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

→ [API 参考](https://developers.anpheros.com/docs) · [Healthcare API](https://developers.anpheros.com/zh/guides/healthcare-api)

## 4. 创建和读取医疗数据

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

→ [入门](https://developers.anpheros.com/zh/guides/getting-started) · [医疗数据 API](https://developers.anpheros.com/zh/guides/medical-data-api) · [构建医疗应用](https://developers.anpheros.com/zh/guides/build-a-healthcare-app)

## 5. 添加同意

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

→ [同意和访问模型](https://developers.anpheros.com/zh/guides/consent) · [身份验证和 OAuth](https://developers.anpheros.com/zh/guides/authentication)

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

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

→ [FHIR 平台](https://developers.anpheros.com/zh/guides/fhir) · [FHIR 代码系统](https://developers.anpheros.com/zh/guides/fhir-code-systems) · [医疗数据互操作性](https://developers.anpheros.com/zh/guides/interoperability)

## 7. 响应事件

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

→ [Webhooks](https://developers.anpheros.com/zh/guides/webhooks) · [Lab connector](https://developers.anpheros.com/zh/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/zh/guides/healthcare-integrations)

## 8. 使用 SDK

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

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

→ [SDKs](https://developers.anpheros.com/zh/guides/sdks)

## 9. 上线生产环境

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

→ [安全、隐私和数据驻留](https://developers.anpheros.com/zh/guides/security) · [限制](https://developers.anpheros.com/zh/guides/limits) · [错误](https://developers.anpheros.com/zh/guides/errors) · [版本控制和弃用](https://developers.anpheros.com/zh/guides/versioning)

## 添加 AI

如果您的产品包含 AI 助手或代理，上下文 API 会在 token 限额内，并为模型使用的每个条目都标明来源，从而准备好记录的相关部分。→ [AI 医疗应用](https://developers.anpheros.com/zh/guides/ai-healthcare)

## 相关资源

- [面向开发者的 Anpheros](https://developers.anpheros.com/zh/guides/developers)
- [医疗软件开发](https://developers.anpheros.com/zh/guides/healthcare-software)
- [医疗初创公司](https://developers.anpheros.com/zh/guides/healthcare-startups)