# Anpheros で構築する

> 認証、API、医療データ、同意、FHIR、Webhook、SDK、そして本番稼働までの9ステップ — 各ステップのガイド付き。

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

**Anpheros 上で構築するとは、アプリケーションの医療データレイヤーとして Anpheros を使用することを意味します。製品は Anpheros API を呼び出して、患者記録を HL7 FHIR R4 で保存・読み取り、患者の同意を取得し、イベントを受信します。** このページは、初回アクセスから本番稼働までのマップであり、各ステップは詳細をカバーするガイドにリンクしています。

## 1. アクセス権の取得

Anpheros Platform はプライベートベータ版です。サンドボックスはセルフサービスです。ダッシュボード（`https://platform.anpheros.com/dashboard/`）で Google でサインインし、「サンドボックスキーを取得」ボタンを押すと、組織、独自の 30 人の合成患者を持つサンドボックスプロジェクト、およびキーが取得されます。本番環境へのアクセスはリクエスト制（`contact@anpheros.com`）です。追加のプロジェクトと API キーは、ダッシュボードまたは Admin API を通じて作成します。OAuth アプリケーションは `POST /admin/projects/{id}/applications` で、Webhook は `POST /v1/webhooks` で登録します。

**プロジェクト**は分離の単位です。プロジェクトのキーは、そのプロジェクトが作成した患者のみ（および、同意を得た患者）を閲覧できます。

## 2. 認証

| クレデンシャル | 対象 | 形式 |
|---|---|---|
| API キー | お客様のサーバー | `sk_test_…` (サンドボックス)、`sk_live_…` (本番環境) |
| OAuth アクセストークン | 患者一人を代理するアプリ | `at_…`、30分間有効、ローテーションされるリフレッシュトークンで更新 |

これを `Authorization: Bearer <credential>` として送信します。キーは一度のみ表示され、モバイルアプリやウェブアプリには絶対に含まれません。→ [認証と OAuth](https://developers.anpheros.com/ja/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/ja/guides/healthcare-api)

## 4. 医療データの作成と読み取り

ユーザーごとに患者を作成し、`Idempotency-Key` を使用して観察結果、状態、投薬、ドキュメントを書き込み、それらをリストまたはタイムラインとして読み戻します。すべての書き込みの作成者を指定します（`patient`、`practitioner`、`device`、`import`、`ai`）。

→ [はじめに](https://developers.anpheros.com/ja/guides/getting-started) · [医療データAPI](https://developers.anpheros.com/ja/guides/medical-data-api) · [ヘルスケアアプリの構築](https://developers.anpheros.com/ja/guides/build-a-healthcare-app)

## 5. 同意の追加

Anpheros に既に記録されている個人に到達するには、リダイレクト URI を指定して OAuth アプリケーションを登録し、必要なスコープと共に同意ページに個人を誘導し、コード (PKCE) をトークンと交換します。個人は期間を選択でき、いつでもアクセスを取り消すことができます。すべての読み取りは個人に表示されます。

→ [同意とアクセスモデル](https://developers.anpheros.com/ja/guides/consent) · [認証と OAuth](https://developers.anpheros.com/ja/guides/authentication)

## 6. 完全なモデルが必要な場合は FHIR を使用する

REST API 以外のリソースタイプ（予防接種、処置、ケアプラン、アレルギー、診察など、合計 26 種類）は、FHIR R4 を通じて利用可能です。検索、履歴、トランザクション、`$everything`、および International Patient Summary (`$summary`) も同様に利用できます。

→ [FHIR プラットフォーム](https://developers.anpheros.com/ja/guides/fhir) · [FHIR コードシステム](https://developers.anpheros.com/ja/guides/fhir-code-systems) · [ヘルスケアデータ相互運用性](https://developers.anpheros.com/ja/guides/interoperability)

## 7. イベントへの対応

`resource.*`、`consent.*`、または`document.finalized` イベントのWebhookエンドポイントを登録し、各配信の`Anpheros-Signature` を検証します。検査レポートは、ラボコネクタへの1回の呼び出しで送信できます。

→ [Webhooks](https://developers.anpheros.com/ja/guides/webhooks) · [Lab connector](https://developers.anpheros.com/ja/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/ja/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
```

→ [SDK](https://developers.anpheros.com/ja/guides/sdks)

## 9. 本番環境への移行

- 本番環境キー (`sk_live_`) は、署名済みのデータ処理契約を締結した認証済み組織に発行されます。
- プライベートベータ版の制限事項を考慮してください：単一ゾーン、契約SLAなし、キーおよびIPあたり毎分600リクエスト。
- エラーはタイプ別に処理し、サポートのために (`Anpheros-Request-Id`) を保持してください。
- データの保護方法と保存場所を確認してください。

→ [セキュリティ、プライバシー、およびデータレジデンシー](https://developers.anpheros.com/ja/guides/security) · [制限事項](https://developers.anpheros.com/ja/guides/limits) · [エラー](https://developers.anpheros.com/ja/guides/errors) · [バージョン管理と廃止](https://developers.anpheros.com/ja/guides/versioning)

## AIの追加

製品にAIアシスタントまたはエージェントが含まれている場合、コンテキストAPIは、トークン予算内で、すべての項目がソースでラベル付けされた状態で、レコードの関連部分をモデルに準備します。→ [AIヘルスケアアプリケーション](https://developers.anpheros.com/ja/guides/ai-healthcare)

## 関連情報

- [開発者向け Anpheros](https://developers.anpheros.com/ja/guides/developers)
- [ヘルスケアソフトウェア開発](https://developers.anpheros.com/ja/guides/healthcare-software)
- [ヘルスケアスタートアップ](https://developers.anpheros.com/ja/guides/healthcare-startups)