# FHIRプラットフォーム：患者同意に基づくマネージドFHIR R4

> マネージドFHIR R4プラットフォーム：26のリソースタイプ、検索、履歴、トランザクション、$everything、IPS、Infernoテスト済みSMART起動、同意と来歴、およびシンプルなREST API。無料サンドボックス。

Source: https://developers.anpheros.com/ja/guides/fhir

**AnpherosはFHIRプラットフォームです — アプリケーションがFHIRバックエンドとして使用するマネージドFHIRデータベース（データストア）です。各患者レコードをHL7 FHIR R4 (4.0.1) リソースとしてネイティブに保存し、`https://platform.anpheros.com/fhir/R4` で公開します。** 標準機能に加えて、同意、来歴、監査機能が追加されています。既にFHIRを扱えるアプリケーションは直接使用できます。そうでないアプリケーションは、よりシンプルなREST API (`/v1`) を使用して、同じIDで同じリソースを読み書きできます。

AIアプリケーションにとって、Anpherosはモデルのコンテキストの出典となるFHIRバックエンドとなります。詳細は [LLMアプリケーションとヘルスケアデータ](https://developers.anpheros.com/ja/guides/llm-healthcare-data) を参照してください。

<!-- visual:fhir-hero -->

## HL7 FHIR とは

FHIR (Fast Healthcare Interoperability Resources) は、Web 上での医療データ交換のための HL7 標準です。FHIR は以下を定義します。

- **リソース**: 各臨床概念を表す、小さく型付けされた JSON (または XML) ドキュメント。例: `Patient`、`Observation`、`Condition`、`MedicationStatement`。
- **リソース間の参照** (`"subject": {"reference": "Patient/123"}`): これにより、レコードは患者を中心としたリソースのグラフとなります。
- **REST API**: 標準的な検索パラメータを使用して、リソースの読み取り、検索、作成、更新、削除を行うための API。
- **バンドル**: 複数のリソースを一度に送信するため (トランザクション) またはドキュメントとして (患者サマリーなど) 使用されます。
- **用語バインディング**: LOINC や ICD-10 などのシステムからのコードを値として持つことができます。
- **プロファイル**: International Patient Summary のような、ユースケースや国に合わせた制約。

R4 (バージョン 4.0.1) は、現在最も広く実装されているリリースです。FHIR をストレージモデルとして使用する (エクスポート形式としてだけでなく) ことは、アプリケーションが書き込む内容と、他の FHIR システムが読み取る内容の間に翻訳レイヤーが存在しないことを意味します。

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "4548-4", "display": "Hemoglobin A1c"}]},
  "subject": {"reference": "Patient/…"},
  "effectiveDateTime": "2026-09-01T08:00:00Z",
  "valueQuantity": {"value": 6.4, "unit": "%", "system": "http://unitsofmeasure.org", "code": "%"}
}
```

## Capability statement

`GET /fhir/R4/metadata` は CapabilityStatement を返します。これは、サポートされているリソースタイプ、それらの検索パラメータ、および操作を示します。これは公開されており、権威あるリストです。以下の表は、2026年9月28日時点のそれを反映しています。

## 26のリソースタイプ

<!-- visual:fhir-map:replace -->

| エリア | リソースタイプ |
|---|---|
| 患者と人物 | `Patient`, `RelatedPerson` |
| 測定と結果 | `Observation` (バイタルサイン、検査、症状、ウェルビーイング、日々の活動と睡眠), `DiagnosticReport` |
| 問題とケア | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| 投薬と予防 | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| 文書と質問票 | `DocumentReference`, `QuestionnaireResponse` |
| 受診 | `Encounter`, `Appointment` |
| ディレクトリ | `Organization`, `Practitioner`, `PractitionerRole` |
| ガバナンス | `Consent`, `Provenance` |
| 拡張ポイント | `Basic` |

患者スコープのすべてのタイプは患者コンパートメントに属するため、`Patient/{id}/$everything`、患者レベルのOAuthスコープおよび同意フィルターがすべてに適用されます。ディレクトリリソース (`Organization`, `Practitioner`, `PractitionerRole`) には患者がいません。これらは同じ環境内のプロジェクト間で読み取り可能であり、作成したプロジェクトのみが変更できます。

## Interactions and operations

<!-- visual:fhir-ops -->

- **Read, search, create, update, delete** on every supported type; search parameters per type are listed in the CapabilityStatement. Unknown search parameters are refused with `400` rather than silently ignored.
- **History**: `GET /fhir/R4/{type}/{id}/_history` returns every version; updates can be made conditional with `If-Match` (a version mismatch answers `412`).
- **Transactions and batches**: `POST /fhir/R4` with a `Bundle` of type `transaction` or `batch`.
- **`Patient/{id}/$everything`**: the whole compartment of one patient.
- **`Patient/{id}/$summary`**: an International Patient Summary (IPS) document `Bundle`, in English or Romanian (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: reports how a lab result measures up to the HL7 Europe laboratory report rules.
- **Paging**: `_count` up to 200; `_revinclude` returns at most 1 000 resources.
- **Idempotency**: `POST` requests accept an `Idempotency-Key`; repeating a request with the same key returns the same answer and creates nothing.

```bash
# latest HbA1c results of one patient, strict FHIR
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" \
     -H "Authorization: Bearer $KEY"

# the patient's International Patient Summary
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" -H "Authorization: Bearer $KEY"
```

## FHIRとよりシンプルなREST API

`/v1`は、FHIRリソースを直接扱いたくない開発者向けに用意されています。患者、観察結果、状態、薬剤、ドキュメント、時系列、来歴、さらにプラットフォーム機能（コンテキスト、ラボインポート、Webhook、用語）をカバーしています。すべての`/v1`オブジェクトには`fhir`参照が含まれているため、アプリケーションは`/v1`から開始し、完全なモデルが必要な部分でFHIRに切り替えることができます。

## FHIR に関する標準

`$summary` は、公式の HL7 バリデーターで検証された（エラー 0 件）国際患者サマリーを生成します。検査結果は HL7 Europe の検査ルール（現在はアドバイザリー）でチェックされます。サードパーティ製アプリは SMART on FHIR スタンドアロン起動を通じて接続します。HL7 v2 `ORU^R01` の検査メッセージは入力として受け入れられます。フォーマット、レベル、交換パターンは [Healthcare data interoperability](https://developers.anpheros.com/ja/guides/interoperability) で説明されています。リソースタイプごとのコードシステムは [FHIR code systems](https://developers.anpheros.com/ja/guides/fhir-code-systems) で説明されています。

## よくある質問

### FHIRプラットフォームとは何ですか？
HL7 FHIRリソースとして健康データを保存し、標準のFHIR REST APIを通じて公開するサービスです。これに、アプリケーションが必要とする標準機能（認可、同意、監査、履歴、および`$everything`や`$summary`のような操作）を追加したものです。AnpherosはマネージドFHIR R4プラットフォームであり、FHIRサーバーを実行する代わりにAnpherosを呼び出します。

### FHIRサーバーとFHIRプラットフォームの違いは何ですか？
FHIRサーバーはデータベース上でFHIR APIを実装します。FHIRプラットフォームは、それを実行し、その周りのレイヤー（患者の同意、来歴、アクセスログ、SDK、Webhook、ラボインポート、サンドボックス）を追加するため、アプリケーションはこれらの部分を構築する必要がありません。

### AnpherosはどのFHIRバージョンをサポートしていますか？
FHIR R4 (4.0.1) をサポートしており、公開されているCapabilityStatementの`/fhir/R4/metadata`に記載されている26のリソースタイプが含まれています。

### Anpheros FHIRプラットフォームは独立してテストされていますか？
オープンソースのInfernoテストキットのSMART App Launch STU2「Standalone Launch」グループは、22/22のテストに合格しています（2026年9月28日実行）。また、International Patient Summaryは公式のHL7バリデーターでエラー0件で検証されます。EHR launchとBulk Data exportはまだサポートされていません。

### FHIRプラットフォームは無料で利用できますか？
はい。サンドボックスは無料で、プロジェクトごとに30人の合成患者が含まれています。本番環境は月額€99からで、最初の月は無料です。

### Anpherosを利用するためにFHIRを使用する必要がありますか？
いいえ。よりシンプルなREST API（`/v1`）は、同じIDで同じリソースを読み書きするため、アプリケーションはフラットなJSONから開始し、フルモデルが必要な場合にFHIRに切り替えることができます。

<!-- visual:cta-fhir -->

## 関連情報

- [FHIRサンドボックス](https://developers.anpheros.com/ja/guides/fhir-sandbox): 無料のプライベートFHIR R4テストサーバー
- [FHIRにおける国際患者サマリー (IPS)](https://developers.anpheros.com/ja/guides/international-patient-summary-fhir)
- [医療データプロベナンスの説明](https://developers.anpheros.com/guides/medical-data-provenance): 誰が何を書き、どのように記録するか
- [FHIR R4を使用した医療記録の保存方法](https://developers.anpheros.com/ja/guides/store-medical-records-fhir): curlを使ったステップバイステップチュートリアル
- [FHIR vs. カスタム医療データベース](https://developers.anpheros.com/ja/guides/fhir-vs-custom-database): 独自のテーブルを設計する場合とFHIRを使用する場合
- [無料のFHIRデータベースとサンドボックス](https://developers.anpheros.com/ja/guides/free-fhir-database)
- [Anpherosと他のFHIRサーバーの比較](https://developers.anpheros.com/ja/guides/fhir-server-comparison)
- [ヘルスケアデータの相互運用性](https://developers.anpheros.com/ja/guides/interoperability)
- [FHIRコードシステム](https://developers.anpheros.com/ja/guides/fhir-code-systems)
- [医療データAPI](https://developers.anpheros.com/ja/guides/medical-data-api)
- [ヘルスケアアプリの構築](https://developers.anpheros.com/ja/guides/build-a-healthcare-app)
- [APIリファレンス (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM vs FHIR](https://developers.anpheros.com/ja/guides/dicom-vs-fhir): FHIRの範囲と医用画像処理の開始点