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

Anpherosで構築する

アクセスから本番稼働までの9ステップ — 認証、API、医療データ、同意、FHIR、Webhook、SDK、本番稼働 — 各ステップのガイド付き。

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

1. アクセス権の取得

Anpheros Platform はプライベートベータ版です。サンドボックスはセルフサービスです。ダッシュボード（https://platform.anpheros.com/dashboard/）で Google でサインインし、「サンドボックスキーを取得」ボタンを押すと、組織、独自の 30 人の合成患者を持つサンドボックスプロジェクト、およびキーが取得されます。本番環境へのアクセスはリクエスト制（[email protected]）です。追加のプロジェクトと 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

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

→ FHIR プラットフォーム · FHIR コードシステム · ヘルスケアデータ相互運用性

7. イベントへの対応

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

→ 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

→ SDK

9. 本番環境への移行

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

→ セキュリティ、プライバシー、およびデータレジデンシー · 制限事項 · エラー · バージョン管理と廃止

AIの追加

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