医療データAPI：選び方、患者記録の読み書きを1時間でマスター

「ヘルスケアAPI」は、病院のHL7 v2フィード、国の電子処方サービス、ウェアラブルベンダーのエクスポート、FHIRサーバーなど、非常に多様なものを指します。もしあなたがヘルスケアアプリ、クリニックツール、またはAIアシスタントを開発しているのであれば、より限定的なものが必要になります。それは、患者の記録を標準フォーマットで保持し、患者が誰にそれを読み取るかを決定できるようにし、そしてクリーンなAPIを提供するバックエンドです。このガイドでは、何を探すべきかを示し、実際のAPIコールを用いて、Anpheros Platformでの最初の1時間の使い方を説明します。

開発者向け技術情報: ヘルスケアAPI · 医療データAPI (developers.anpheros.comにて、リクエスト、レスポンス、制限事項を記載) このページは平易な言葉での説明です。

ヘルスケアデータAPIが果たすべきこと

データベースにHTTPを付けただけのものと、実用的なヘルスデータAPIを分ける5つの要素があります。

• 標準フォーマット。 HL7 FHIR R4 は、病院、国のシステム、EUのヘルスデータスペースが使用するフォーマットです。FHIRで保存された記録は、カスタムブリッジなしで他のシステムが読み取ることができます。独自のJSONではそれができません。
• 患者の同意を第一級オブジェクトとして扱うこと。 誰が、いつ、何を、どのくらいの期間読み取れるか、そしてそれは取り消し可能で、患者が確認できること。これは、あなた自身のデータベースにあるチェックボックスではありません。
• 来歴（Provenance）。 すべての値には、誰がそれを記録したかが明記されます：患者、医療従事者、デバイス、インポート、派生計算。検査結果と自己申告の推測を区別できないAIアシスタントは危険です。
• 現実的なデータを持つサンドボックス。 実際の患者でテストすることはできませんし、自分で30人の合成患者と6ヶ月分の履歴を考案する必要もありません。
• データレジデンシーを明示できること。 ヨーロッパのユーザーにとっては、GDPRの下で、データ処理契約を締結したEU域内のサーバーを意味します。

2つのアクセス方法：RESTとFHIR、同じデータ

Anpheros Platformは、同じ記録を2つの方法で公開します。製品コード用のシンプルな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でコード化されています。

キーの取得は1分で完了

サンドボックスはセルフサービスで無料です。platform.anpheros.com/dashboardでダッシュボードにサインインし、「サンドボックスキーを取得」ボタンを押すだけで、組織、サンドボックスプロジェクト、そしてsk_test_…キーが手に入ります。プロジェクトには、30人の合成患者のコピーが付属しています。EU全域の成人、子供、高齢者で、病状、処方薬、アレルギー、検査結果、バイタルサインが6ヶ月分記録されています。内容を変更したり削除したりしても、リセットすれば元に戻ります。

本番環境用のキー（sk_live_…）は、検証済みの組織に、データ処理契約を締結した上で発行されます。サンドボックスと本番環境は異なるデータベースです。サンドボックスキーでは、実際の患者データに物理的にアクセスすることはできません。

その他の機能

• OAuth 2.1 (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）およびQRコードでの共有用SMART Health Links。
• SDK：DartおよびTypeScript用、/docsでのOpenAPIリファレンス、/fhir/R4/metadataでのCapabilityStatement。

完全なウォークスルー（レスポンス付き）は、developers.anpheros.com/guides/first-hourでご覧いただけます。

よくある質問

今日から始められる無料のヘルスケアAPIはありますか？

はい。Anpherosのサンドボックスは無料でセルフサービスです。サインインしてキーを取得すれば、30人の合成患者に対して読み書きが可能です。プロジェクトあたりの制限は、1日あたり10,000件のリソース書き込み、自身の患者100人、ドキュメント250MBです。

RESTとFHIR、どちらを使うべきですか？

/v1は、独自の製品コードに使用してください。シンプルでプレーンなJSONが返されます。/fhir/R4は、他のシステムがデータを読み取る必要がある場合、FHIR検索、_history、$everything、$summaryが必要な場合、または認証で要求される場合に使用してください。どちらも同じ記録を参照します。

患者の同意はどのように扱われますか？

個人はOAuthを通じて、スコープと期間（30日、90日、180日、または365日）を選択して、自身の記録へのアクセスをアプリケーションに付与します。この許可はいつでも取り消すことができ、患者はすべての読み取りアクセスをアクセスログで確認できます。詳細は同意モデルをご覧ください。

データはどこにホストされますか？

欧州連合（Cloud Run, europe-west4）です。すべての書き込みには来歴とバージョン履歴が記録されます。本番環境での使用には、データ処理契約の締結が必要です。

本番環境の料金はいくらですか？

本番環境は、2,500人の保存患者で月額€49から開始します。最初の月は無料です。より大規模なプランは月額€199および€799です。サンドボックスは引き続き無料です。料金をご覧ください。

AIエージェントと連携できますか？

はい。来歴ラベルとトークン予算を備えたAIコンテキストAPIがあり、platform.anpheros.com/mcpにあるMCPサーバーには、MCP対応のアシスタントが接続できます。EMR統合とAI医療アシスタントをご覧ください。