# 縦断的患者データAPI

> クリニック、検査機関、アプリ、デバイスからの患者の経時的な履歴：縦断的記録に必要なものと、タイムライン、$everything、IPS、AIコンテキストの4つの読み取り方法。

Source: https://developers.anpheros.com/ja/guides/longitudinal-patient-data-api

**縦断的患者データAPIは、1人の患者の経時的な健康履歴（診断、投薬、検査結果、バイタルサイン、予防接種、受診歴など）を、プロバイダーごとの個別のドキュメントではなく、単一の順序付けられた記録として返します。** Anpherosは、その履歴を患者ごとに単一のHL7 FHIR R4レコードとして保持し、クリニック、検査機関、アプリ、デバイスによって書き込まれ、すべてのバージョンとすべての著者が保持されます。開発者は4つの方法で読み取ることができます。時系列のタイムライン、$everything `Patient/$everything` を含む完全なFHIRレコード、International Patient Summary、またはAIモデル用のコンパクトなコンテキストです。

<!-- visual:longitudinal-sources -->

## 「縦断的」レコードに必要なもの

結果のリストは、それだけでは縦断的なレコードとは言えません。アプリケーションが数年、あるいは複数のプロバイダーにまたがる履歴を信頼するためには、各エントリは以下の情報を持つ必要があります。

| 要件 | なぜ重要か | Anpheros での保存方法 |
|---|---|---|
| コード化された意味 | 異なるラボからの値は比較可能でなければならない | 結果は LOINC、病状は ICD-10、薬剤は ATC を使用 |
| 臨床上の日付 | アップロードされた日時ではなく、発生した日時で並べ替えられる | 各リソースの `effective`、`onset`、`occurrence` の日付 |
| 作成者 | 医師の診断と患者のメモは同等ではない | すべての書き込みに対する Provenance: 作成者のタイプ、人物、組織、ソースシステム |
| すべてのバージョン | 修正によって以前の情報が消去されてはならない | 各リソースのバージョン履歴 (`_history`) |
| 同意 | 本人が同意した場合にのみ、他のアプリケーションが履歴を参照できる | スコープ、有効期限、アクセスログ付きの OAuth グラント |

## 1つのレコード、複数のライター

<!-- visual:longitudinal-timeline -->

## 履歴を読み取る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 を使用したタイムライン：

```ts
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形式の同じレコード：

```bash
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人の合成患者から始まります。

<!-- visual:cta-longitudinal -->

## 関連情報

- [FHIR を使用した個人健康記録 (PHR) アプリ](https://developers.anpheros.com/ja/guides/personal-health-record-app): 実アプリにおけるタイムライン
- [医療データ来歴の説明](https://developers.anpheros.com/guides/medical-data-provenance)
- [ヘルスケアアプリ向け患者同意プラットフォーム](https://developers.anpheros.com/ja/guides/patient-consent-platform)
- [FHIR R4 を使用した医療記録の保存方法](https://developers.anpheros.com/ja/guides/store-medical-records-fhir)
- [AI エージェントと医療データ](https://developers.anpheros.com/ja/guides/ai-agents-medical-data): コンテキストエンドポイント
- [Webhook](https://developers.anpheros.com/ja/guides/webhooks)