# ヘルスケア統合

> 現在サポートされている統合パターン：1回の呼び出しでの検査レポート、組織の名義で書き込むクリニック、デバイス、同意済みのサードパーティアプリ、Webhook、SDK — および利用できないもの。

Source: https://developers.anpheros.com/ja/guides/healthcare-integrations

**ヘルスケア統合とは、健康データを生成または必要とするシステム（検査室、クリニック、デバイス、他のアプリケーションなど）を患者の記録に接続することです。** Anpherosでは、すべての統合は同じAPIとルールを経由します。データはHL7 FHIR R4として書き込まれ、そのソースに帰属し、患者に表示され、患者の同意なしに他の当事者と共有されることはありません。このページでは、プラットフォームが現在サポートしている統合パターンについて説明します。

[Anpheros統合ディレクトリを探索する](https://anpheros.com/integrations)と、各統合の検証済みステータス（利用可能、ベータ版、開発者ガイド）、交換されるデータとFHIRリソース、方向、認証、およびドキュメントを確認できます。

## 検査: 1回の呼び出しでレポート全体を取得

検査機関、または検査レポートを保持するシステムは、完全なレポートを送信し、プラットフォームはすべての結果を検査結果として扱います。`Observation`:

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- フォーマット: **CSV** (ルーマニア語または英語のヘッダー、小数点コンマ対応)、**HL7 v2 ORU^R01**、および **JSON**。
- マーカーは、レポートがコードを提供している場合、または名前がプラットフォームの用語と一致する場合に **LOINC** にマッピングされます。それ以外の場合は、検査機関固有のコードが保持され、`unmapped` としてリストされます。
- 各行には安定した識別子が割り当てられるため、**同じレポートを再送信しても、すでにインポートされたものはスキップされます**。
- リクエストあたり最大500行。各結果には、ソースシステムとレポートの名前を示すプロベナンスが含まれます。

詳細: [Lab connector](https://developers.anpheros.com/ja/guides/lab-connector)。

## クリニック：組織の代理として書き込む

クリニックとそのそこで働く人々は、ディレクトリリソースです（`Organization`、`Practitioner`、`PractitionerRole`）。クリニックのシステムは、各リクエストの背後に誰がいるかを伝えることができます。

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — あなたのアプリケーションを通じて作業している施術者。アクセスログに書き込まれ、患者に名前で表示されます。
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — 書き込みが行われる組織。
- `X-Anpheros-Author-Ref: Practitioner/<id>` — `Provenance` に記録されている作成者。

患者の同意を得て、クリニックは他の組織が書いたものを含むレコード全体を読み取り、自身が書いたものだけを変更します。FHIR `transaction` バンドル（`POST /fhir/R4`）を使用して、複数のリソースをアトミックに書き込むことができます。

ディレクトリから1つのトランザクションとして書き込まれた訪問までの、実演例：[クリニックシステムをFHIRバックエンドと統合する方法](https://developers.anpheros.com/ja/guides/integrate-clinic-systems-fhir)。

患者のアプリでの同意 → ラボ `Observation` （クリニックプロジェクトによって書き込まれる） → 通知の流れは、テストクリニックプロジェクトでエンドツーエンドで実行されました。

## デバイスとウェアラブル

デバイスからの測定値は、`author_type: "device"`とLOINCコードを持つ`Observation`です。心拍数、血圧、SpO₂、体重、血糖値、歩数、睡眠時間などが含まれます（[FHIRコードシステム](https://developers.anpheros.com/ja/guides/fhir-code-systems)参照）。Anpheros Dailyは、Apple HealthおよびHealth Connectから読み取った日次サマリーを、同様の方法でObservationとして書き込みます。Anpherosはデバイスベンダーのクラウドに直接接続しません。アプリケーションまたはバックエンドがデバイスから読み取り、結果を書き込みます。Apple Health、Health Connect、Samsung Healthの読み取り方法と、各メトリックをLOINCにマッピングする方法については、[FHIRにおけるウェアラブルデータ](https://developers.anpheros.com/ja/guides/wearable-data-fhir)を参照してください。

## サードパーティアプリケーション：同意に基づくアクセス

Anpheros に保存されているデータを必要とするアプリケーションは、一度登録し、OAuth 2.1 with PKCE (SMART on FHIR standalone launch) を通じて同意を求めます。

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — ホストされた同意ページ。
2. ユーザーはレコードと期間（30日、90日、180日、または365日）を選択します。
3. `POST /oauth/token` はコードをアクセストークン（30分）とローテーションリフレッシュトークン（30日）と交換します。
4. アプリケーションは、そのスコープ内でのみ、自身のペアワイズ ID の下で、その患者のみを参照できます。

[認証と OAuth](https://developers.anpheros.com/ja/guides/authentication)

## イベント：変更への対応

ポーリングの代わりに、Webhook を登録します。配信は HMAC-SHA256 で署名され、最大 24 時間バックオフで再試行され、ID を運びますが、臨床コンテンツは運びません。別のプロジェクトがアクセス可能なレコードに書き込んだ場合、イベントはその旨を示します（`data.external: true`、ソース付き）。[Webhook](https://developers.anpheros.com/ja/guides/webhooks)

## SDK

TypeScript (`@anpheros/sdk`) および Dart / Flutter (`anpheros_sdk`) SDK は、上記すべて — 検査結果のインポート (`labs.importCsv`, `labs.importHl7`, `labs.importItems`)、PKCE を使用した OAuth、Webhook の管理、署名検証 — を実装しています。[SDK](https://developers.anpheros.com/ja/guides/sdks)

## 利用できないもの

- 特定の病院EHRまたは検査情報システム向けの既製のコネクタ。統合はAPIに対して構築されます。
- SMART EHR起動（EHR内からの起動）。スタンドアロン起動のみがサポートされています。
- デバイスベンダーとの直接統合。

## 関連情報

- [FHIRバックエンドとのクリニックシステム統合方法](https://developers.anpheros.com/ja/guides/integrate-clinic-systems-fhir): クリニックEMR向けのステップバイステップチュートリアル
- [医療データの正規化方法](https://developers.anpheros.com/ja/guides/normalize-medical-data): コード、単位、日付、重複、検証
- [FHIRレコードへの検査結果のインポート方法](https://developers.anpheros.com/ja/guides/import-lab-results-fhir): CSVおよびHL7 v2を使用したステップバイステップチュートリアル
- [ヘルスケアデータ相互運用性](https://developers.anpheros.com/ja/guides/interoperability)
- [ヘルスケアAPI](https://developers.anpheros.com/ja/guides/healthcare-api)
- [アーキテクチャ](https://developers.anpheros.com/ja/guides/architecture)
- [ユースケース](https://developers.anpheros.com/ja/guides/use-cases)