Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
経時的患者データAPI
診療所、検査機関、アプリ、デバイスからの患者の経時的履歴：経時的記録に必要なもの、および読み取り方法4つ（タイムライン、$everything、IPS、AIコンテキスト）を説明します。
縦断的患者データAPIは、1人の患者の経時的な健康履歴（診断、投薬、検査結果、バイタルサイン、予防接種、受診歴など）を、プロバイダーごとの個別のドキュメントではなく、単一の順序付けられた記録として返します。 Anpherosは、その履歴を患者ごとに単一のHL7 FHIR R4レコードとして保持し、クリニック、検査機関、アプリ、デバイスによって書き込まれ、すべてのバージョンとすべての著者が保持されます。開発者は4つの方法で読み取ることができます。時系列のタイムライン、$everything Patient/$everything を含む完全なFHIRレコード、International Patient Summary、またはAIモデル用のコンパクトなコンテキストです。
- ClinicsVisits, diagnoses and prescriptions as FHIR R4
- LaboratoriesHL7 v2, CSV or JSON reports become Observations
- Apps and devicesReadings from phones, watches and home devices
- One FHIR recordEvery version kept, every write with provenance
- Your applicationTimeline, $everything, IPS summary or AI context
「縦断的」レコードに必要なもの
結果のリストは、それだけでは縦断的なレコードとは言えません。アプリケーションが数年、あるいは複数のプロバイダーにまたがる履歴を信頼するためには、各エントリは以下の情報を持つ必要があります。
| 要件 | なぜ重要か | Anpheros での保存方法 |
|---|---|---|
| コード化された意味 | 異なるラボからの値は比較可能でなければならない | 結果は LOINC、病状は ICD-10、薬剤は ATC を使用 |
| 臨床上の日付 | アップロードされた日時ではなく、発生した日時で並べ替えられる | 各リソースの effective、onset、occurrence の日付 |
| 作成者 | 医師の診断と患者のメモは同等ではない | すべての書き込みに対する Provenance: 作成者のタイプ、人物、組織、ソースシステム |
| すべてのバージョン | 修正によって以前の情報が消去されてはならない | 各リソースのバージョン履歴 (_history) |
| 同意 | 本人が同意した場合にのみ、他のアプリケーションが履歴を参照できる | スコープ、有効期限、アクセスログ付きの OAuth グラント |
1つのレコード、複数のライター
- Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
- Metformin 500 mgMedicationStatement · ATC A10BA02
- HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
- Influenza vaccineImmunization · written by the pharmacy
- Cardiology visitEncounter · written by the clinic
- Blood pressure 138/86 mmHgObservation · from the patient's app
Condition Medication Observation Immunization Encounter
履歴を読み取る4つの方法
| ニーズ | エンドポイント | 取得できるもの |
|---|---|---|
| 画面用の時系列フィード | GET /v1/patients/{id}/timeline |
8つのタイプ（observation, condition, medication, document, encounter, appointment, immunization, episode）のアイテム。日付、タイトル、概要、FHIR参照が含まれます。from、to、types でフィルタリング可能 |
| FHIR形式の完全なレコード | GET /fhir/R4/Patient/{id}/$everything |
Searchset Bundle。_since、_type、_count、_offset がサポートされています |
| 共有可能な臨床サマリー | GET /fhir/R4/Patient/{id}/$summary |
International Patient Summary (IPS) ドキュメント |
| AIモデルへの入力 | POST /v1/context |
トークン予算内のセクション。各事実はソースとともにラベル付けされます |
TypeScript SDK を使用したタイムライン：
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) }); // a sandbox key, sk_test_…
const { data: patients } = await anpheros.patients.list();
const page = await anpheros.timeline.list(patients[0].id, {
from: '2025-01-01',
types: 'condition,medication,observation',
limit: 50,
});
for (const item of page.data) console.log(item.date, item.type, item.title);
そして、日付以降に変更されたものに限定された、FHIR形式の同じレコード：
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
"https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
コピーの同期を維持する
アプリケーションが履歴の独自のビューを保持している場合は、resource.created、resource.updated、およびresource.deleted の Webhook を購読してください。これらは、他のプロジェクトがアクセス可能なレコードに書き込んだ場合にもトリガーされ、data.external: true と書き込み元がdata.source に含まれるため、ポーリングなしで他のクリニックからのデータが届きます。
知っておくべき制限事項
- レコードには、書き込まれた内容が保持されます。Anpheros は、病院や国のネットワークから履歴を独自に取得することはありません。クリニック、ラボ、アプリ、そして個人がそれを書き込みます。
- 26 種類の FHIR R4 リソースが保存されます。Claim や ExplanationOfBenefit などの請求リソースは保存されません。
- 他のアプリケーションは、その個人の同意を得てのみ、その個人の履歴を読み取ります。プロジェクト固有のキーは、それが作成した患者を閲覧できます。
よくある質問
ロングチュディナル患者データとは何ですか？
個人の健康情報が、診断、投薬、検査結果、バイタルサイン、予防接種、受診記録など、ケアの提供場所を超えて経時的に収集され、一つの連続した履歴として読み取れるように保存されたものです。
患者の記録を時系列で表示するAPIはどれですか？
Anpherosでは、GET /v1/patients/{id}/timeline が8つのリソースタイプのエントリを日付順に、ページネーション、日付およびタイプフィルター付きで返します。完全なFHIRデータについては、Patient/$everything を参照してください。
履歴は標準フォーマットで保存されていますか？
はい。すべてのエントリはHL7 FHIR R4リソースであり、標準コード（LOINC、ICD-10、ATC、CVX、UCUM）が使用されています。サマリーはInternational Patient Summaryです。
各エントリを誰が作成したかを知るにはどうすればよいですか？
すべての書き込みは、作成者のタイプ（患者、医療従事者、デバイス、インポートまたはAI）、人物、組織、およびソースシステムを含むProvenanceリソースを作成します。
現実的なロングチュディナルデータでテストできますか？
はい。すべてのサンドボックスプロジェクトは、約6ヶ月分の病状、投薬、検査結果、バイタルサインを持つ30人の合成患者から始まります。
関連情報
- FHIR を使用した個人健康記録 (PHR) アプリ: 実アプリにおけるタイムライン
- 医療データ来歴の説明
- ヘルスケアアプリ向け患者同意プラットフォーム
- FHIR R4 を使用した医療記録の保存方法
- AI エージェントと医療データ: コンテキストエンドポイント
- Webhook
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card