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

ヘルスケア連携

現在サポートされている連携パターン：1回のAPIコールでの検査レポート、組織の代理としての診療所からの書き込み、デバイス、同意されたサードパーティアプリ、Webhook、SDK。利用できないものについても説明します。

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

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

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

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

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。

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

クリニックとそのそこで働く人々は、ディレクトリリソースです（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バックエンドと統合する方法。

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

デバイスとウェアラブル

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

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

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

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

認証と OAuth

イベント：変更への対応

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

SDK

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

利用できないもの

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