# API pro longitudinální data pacienta

> Historie jednoho pacienta v průběhu času z klinik, laboratoří, aplikací a zařízení: co longitudinální záznam potřebuje a čtyři způsoby, jak jej číst — časová osa, $everything, IPS a kontext AI.

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

**API pro longitudinální data pacienta vrací zdravotní historii jedné osoby v průběhu času — diagnózy, léky, laboratorní výsledky, vitální funkce, očkování a návštěvy z každého zdroje — jako jeden uspořádaný záznam namísto samostatných dokumentů pro každého poskytovatele.** Anpheros uchovává tuto historii jako jediný záznam HL7 FHIR R4 na pacienta, zapsaný klinikami, laboratořemi, aplikacemi a zařízeními, přičemž je zachována každá verze a každý autor. Vývojáři jej čtou čtyřmi způsoby: chronologickou časovou osou, plným FHIR záznamem s `Patient/$everything`, International Patient Summary nebo kompaktním kontextem pro modely AI.

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

## Co vyžaduje „longitudinal“

Seznam výsledků ještě není longitudinalní záznam. Aby aplikace mohla důvěřovat historii, která pokrývá roky a poskytovatele, musí každý záznam obsahovat:

| Požadavek | Proč je důležitý | Jak Anpheros ukládá |
|---|---|---|
| Kódovaný význam | Hodnoty z různých laboratoří musí být porovnatelné | LOINC pro výsledky, ICD-10 pro stavy, ATC pro léky |
| Klinické datum | Seřazení podle toho, kdy se událo, nikoli kdy bylo nahráno | `effective`, `onset`, `occurrence` data na každém zdroji |
| Autor | Diagnóza lékaře a poznámka pacienta nejsou stejné | Provenance při každém zápisu: typ autora, osoba, organizace, zdrojový systém |
| Každá verze | Opravy nesmí vymazat to, co bylo známo dříve | Historie verzí na každém zdroji (`_history`) |
| Souhlas | Jiné aplikace vidí historii pouze tehdy, pokud s tím osoba souhlasí | Granty OAuth s rozsahy, expirací a logem přístupu |

## Jeden záznam, mnoho pisatelů

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

## Čtyři způsoby čtení historie

| Potřeba | Koncový bod | Co získáte |
|---|---|---|
| Chronologický přehled pro obrazovku | `GET /v1/patients/{id}/timeline` | Položky osmi typů (observation, condition, medication, document, encounter, appointment, immunization, episode) s datem, názvem, souhrnem a referencí FHIR; filtrujte pomocí `from`, `to`, `types` |
| Kompletní záznam jako FHIR | `GET /fhir/R4/Patient/{id}/$everything` | Bundle typu searchset; podporovány jsou `_since`, `_type`, `_count` a `_offset` |
| Sdílitelný klinický souhrn | `GET /fhir/R4/Patient/{id}/$summary` | Dokument International Patient Summary (IPS) |
| Vstup pro AI model | `POST /v1/context` | Sekce v rámci rozpočtu tokenů, každý fakt označený svým zdrojem |

Časová osa s 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);
```

A stejný záznam jako FHIR, omezený na to, co se změnilo od určitého data:

```bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
  "https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
```

## Udržování synchronizace vaší kopie

Pokud vaše aplikace udržuje vlastní pohled na historii, přihlaste se k odběru webhooků `resource.created`, `resource.updated` a `resource.deleted`. Tyto webhooky se spustí také v případě, že jiný projekt zapíše do záznamu, ke kterému máte přístup, s údaji `data.external: true` a zapisovatelem v `data.source`, takže se k vám data z jiných klinik dostanou bez nutnosti opakovaného dotazování.

## Limity, které je dobré znát

- Záznam obsahuje to, co do něj bylo zapsáno. Anpheros si sám nestahuje historii z nemocnic nebo národních sítí; zapisují ji kliniky, laboratoře, aplikace a samotná osoba.
- Ukládá se 26 typů zdrojů FHIR R4. Zdroje fakturace, jako jsou Claim a ExplanationOfBenefit, se neukládají.
- Jiné aplikace čtou historii osoby pouze s jejím souhlasem; klíč projektu vidí pacienty, které vytvořil.

## Často kladené dotazy

### Co jsou longitudinální data pacienta?
Zdravotní informace osoby shromážděné v průběhu času a napříč různými místy péče – diagnózy, léky, výsledky, vitální funkce, očkování a návštěvy – uchovávané tak, aby je bylo možné číst jako jeden souvislý záznam.

### Které API poskytuje chronologický pohled na záznam pacienta?
V Anpheros, `GET /v1/patients/{id}/timeline` vrací záznamy z osmi typů zdrojů v chronologickém pořadí, s stránkováním a filtry podle data a typu. Pro kompletní FHIR data použijte `Patient/$everything`.

### Je historie uložena ve standardním formátu?
Ano. Každý záznam je HL7 FHIR R4 zdroj se standardními kódy (LOINC, ICD-10, ATC, CVX, UCUM) a souhrn je International Patient Summary.

### Jak poznám, kdo vytvořil každý záznam?
Každý zápis vytváří zdroj Provenance s typem autora (pacient, praktikující lékař, zařízení, import nebo AI), osobou, organizací a zdrojovým systémem.

### Mohu testovat s realistickými longitudinálními daty?
Ano. Každý sandbox projekt začíná s 30 syntetickými pacienty s přibližně šesti měsíci anamnézy, medikace, laboratorních výsledků a vitálních funkcí.

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

## Související

- [Aplikace osobního zdravotního záznamu (PHR) s FHIR](https://developers.anpheros.com/cs/guides/personal-health-record-app): časová osa v reálné aplikaci
- [Vysvětlení původu lékařských dat](https://developers.anpheros.com/cs/guides/medical-data-provenance)
- [Platforma pro souhlas pacienta pro zdravotnické aplikace](https://developers.anpheros.com/cs/guides/patient-consent-platform)
- [Jak ukládat lékařské záznamy pomocí FHIR R4](https://developers.anpheros.com/cs/guides/store-medical-records-fhir)
- [AI agenti a lékařská data](https://developers.anpheros.com/cs/guides/ai-agents-medical-data): koncový bod kontextu
- [Webhooks](https://developers.anpheros.com/cs/guides/webhooks)