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

ヘルスケアAPI：概要と仕組み

Q: データはどこに保存されますか？

欧州連合内です。サービスとそのデータベースは、Google Cloud europe-west4（オランダ）で実行されます。

ヘルスケアAPIとは何か、APIコールがどのように機能するか、注目すべき点、そして患者同意、来歴、EUホスティングを備えた無料FHIR R4ヘルスケアAPIについて、例とFAQを交えて説明します。

ヘルスケアAPIとは、ソフトウェアが患者記録、観察結果、診断、投薬、文書などの医療データを読み書きするためのプログラムインターフェースであり、そのデータへのアクセスを承認するためのものです。 Anpheros Platform APIは、患者が管理するHL7 FHIR R4レコード上のヘルスケアAPIです。アプリケーションはこれを使用して、医療データを保存および取得し、患者の同意を得て、変更の通知を受け取ることができます。

ヘルスケアAPI呼び出しの仕組み

ベンダーを問わず、ヘルスケアAPI呼び出しは以下のチェックポイントを通過します。誰が呼び出しているか、どの患者とどのデータにアクセスできるか、データはどこに保存されているか、誰がそれを書いたか、そして誰が変更を知る必要があるか。

What happens in one healthcare API call

Your appSends a request with an API key or a patient's OAuth token
AuthorisationKey → your project's patients; token → one patient, granted scopes only
FHIR recordRead or write a coded resource; every version kept
Provenance + auditWho wrote it, for which organisation; the read is logged
EventsA signed webhook tells your other systems what changed

ヘルスケアAPIの種類

種類	交換するもの	一般的な用途
FHIR REST API	HTTP経由のFHIRリソース (`GET /Observation?patient=…`)	臨床データ交換の最新標準
SMART on FHIR / OAuth	FHIR APIの認可	ユーザーの許可を得て、サードパーティ製アプリがレコードにアクセスできるようにする
HL7 v2 メッセージング	パイプ区切りメッセージ (結果は`ORU^R01`、入院は`ADT`)	研究所および病院システム、多くの場合HTTPではなくインターフェース経由
ドキュメント交換	臨床ドキュメント (PDF、CDA、FHIRドキュメントバンドル)	要約、退院サマリー、紹介状
プロプライエタリREST API	ベンダー固有のJSON	単一製品の独自のモバイルアプリまたは統合

Anpherosは、最初の2つをコアとして組み合わせ、HL7 v2の検査結果を入力として受け入れ、元のドキュメントとともにドキュメントを保存し、FHIRドキュメントバンドル（国際患者サマリー）を生成します。また、FHIRを直接扱いたくない開発者向けに、同じデータに対するよりシンプルなREST APIも提供します。

ヘルスケアAPIで確認すべきこと

What to look for in a healthcare API — and how Anpheros answers

Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM

Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation

ProvenanceAuthor, organisation and source on every write

HistoryEvery version kept; conditional updates with If-Match

Audit of readsEach read and write logged, visible to the patient

Safe retriesIdempotency-Key on POST; predictable errors

IsolationPairwise patient ids per application

Data residencyEuropean Union: Google Cloud europe-west4

このページの残りの部分では、これらの各項目が Anpheros API でどのように実現されているかを示します。

Anpheros API の概要

サーフェス	ベースパス	目的
FHIR R4	`/fhir/R4`	26 のリソースタイプ; 読み取り、検索、作成、更新、削除、履歴、トランザクション、`$everything`、`$summary`、`$validate`
REST v1	`/v1`	patients, observations, conditions, medications, documents, timeline, provenance, AI context, lab import, terminology, webhooks
OAuth 2.1	`/oauth`	consent page, tokens (PKCE), revocation, OpenID Connect keys
Patient side	`/me`	a person's own records, who has access, access log, revoke
Discovery	`/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json`	machine-readable descriptions of the API

Base URL: https://platform.anpheros.com. サンドボックスと本番環境で共有されます。キーがデータプレーンを決定します。

認証

API keys (sk_test_…, sk_live_…): サーバー用。プロジェクトが作成した患者を表示できます。
OAuth access tokens (at_…): 同意を得て、患者のために動作するアプリケーション用。

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

安全な書き込み

POST リクエストは Idempotency-Key を受け入れます。同じキーで再試行されたリクエストは元のレスポンスを返し、何も作成しません。すべての書き込みには Provenance が付与されます。作成者のタイプは、ボディ (author_type) またはヘッダー (X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id, X-Anpheros-On-Behalf-Of など) で送信されます。

curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

エラーと制限

FHIR エンドポイントは OperationOutcome で応答し、その他は {"error": {"type", "message", "field"}} で応答します。すべてのレスポンスには Anpheros-Request-Id が含まれます。デフォルトの制限は、キーおよび IP ごとに 1 分あたり 600 リクエストです。Errors · Limits

イベント

resource.created、resource.updated、resource.deleted、consent.granted、consent.revoked、document.finalized、ping のための署名付き Webhook。Webhooks

FHIR と REST v1 の選択

FHIR は、既に FHIR を利用している場合、/v1 がカバーしていないリソースタイプ（例：Immunization、Procedure、CarePlan）が必要な場合、または他の FHIR システムとデータを交換する場合に使用します。REST v1 は、一般的なケースでフラットな JSON を必要とするアプリケーションコードに使用します。どちらも同じリソースを同じ ID で読み書きするため、プロジェクトで混在させることが可能です。Medical data API にデータ操作の詳細が記載されています。

よくある質問

ヘルスケアAPIとは何ですか？

ソフトウェアが患者記録、観察結果、診断、投薬、ドキュメントなどの医療データを読み書きするためのプログラムインターフェースであり、そのデータへのアクセスを承認するためのものです。最新のヘルスケアAPIは、データにはHL7 FHIR R4を、承認にはOAuth 2.0または2.1とSMART on FHIRを使用しています。

ヘルスケアAPIとFHIR APIの違いは何ですか？

FHIRは、ヘルスケアAPIが従うことができる標準の1つです。FHIR APIはREST over FHIRリソースを交換しますが、ヘルスケアAPIはHL7 v2メッセージ、ドキュメント、または独自のJSONも受け入れる場合があります。Anpherosは、FHIR R4 APIと、同じデータに対するよりシンプルなREST APIを提供しています。

開発者向けの無料ヘルスケアAPIはありますか？

はい。Anpherosサンドボックスは無料でセルフサービスです。Googleでサインインし、APIキーを取得して、FHIR R4またはRESTで30人の合成患者を操作できます。本番環境は月額€99からで、最初の月は無料です。

患者はヘルスケアAPIへの同意をどのように提供しますか？

OAuth 2.1とPKCEを介して行われます。アプリケーションはユーザーをSMART on FHIRスコープ付きの同意ページに誘導します。ユーザーは、何をどれくらいの期間共有するかを選択し、アクセスログを確認し、いつでもアクセスを取り消すことができます。

データはどこに保存されますか？

欧州連合内です。サービスとそのデータベースは、Google Cloud europe-west4（オランダ）で実行されます。

どのヘルスケアAPIを選択すべきですか？

データ標準、アクセスを承認する主体、出所と監査、データの居住地、リトライとエラーの動作、そしてリアルなデータで無料でテストできるかどうかを比較してください。ヘルスケアAPIプラットフォーム：内容と選び方では、これらをベンダーに尋ねるべき質問にまとめています。