# API pre longitudinálne dáta pacienta

> História jedného pacienta v priebehu času z kliník, laboratórií, aplikácií a zariadení: čo longitudinal record potrebuje a štyri spôsoby, ako ho čítať — časová os, $everything, IPS a kontext AI.

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

**API pre longitudinálne dáta pacienta vracia zdravotnú históriu jednej osoby v priebehu času — diagnózy, lieky, výsledky laboratórnych testov, vitálne funkcie, očkovania a návštevy z každého zdroja — ako jeden usporiadaný záznam namiesto samostatných dokumentov na poskytovateľa.** Anpheros uchováva túto históriu ako jeden HL7 FHIR R4 záznam na pacienta, zapísaný klinikami, laboratóriami, aplikáciami a zariadeniami, pričom sa uchováva každá verzia a každý autor. Vývojári ho čítajú štyrmi spôsobmi: chronologická časová os, plný FHIR záznam s `Patient/$everything`, International Patient Summary alebo kompaktný kontext pre AI modely.

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

## Čo vyžaduje "longitudinálne"

Zoznam výsledkov ešte nie je longitudinálny záznam. Aby aplikácia mohla dôverovať histórii, ktorá pokrýva roky a rôznych poskytovateľov, každá položka musí obsahovať:

| Požiadavka | Prečo je dôležitá | Ako Anpheros uchováva |
|---|---|---|
| Kódovaný význam | Hodnoty z rôznych laboratórií musia byť porovnateľné | LOINC pre výsledky, ICD-10 pre diagnózy, ATC pre lieky |
| Klinický dátum | Usporiadanie podľa toho, kedy sa udialo, nie kedy bolo nahrané | dátumy `effective`, `onset`, `occurrence` na každom zdroji |
| Autor | Diagnóza lekára a poznámka pacienta nie sú rovnaké | Proveniencia pri každom zápise: typ autora, osoba, organizácia, zdrojový systém |
| Každá verzia | Opravy nesmú vymazať to, čo bolo známe predtým | História verzií na každom zdroji (`_history`) |
| Súhlas | Iné aplikácie vidia históriu iba vtedy, ak s tým osoba súhlasí | OAuth granty so scopes, expiráciou a logom prístupu |

## Jeden záznam, viacero zapisovateľov

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

## Štyri spôsoby čítania histórie

| Potreba | Koncový bod | Čo získate |
|---|---|---|
| Chronologický feed pre obrazovku | `GET /v1/patients/{id}/timeline` | Položky ôsmich typov (observation, condition, medication, document, encounter, appointment, immunization, episode) s dátumom, názvom, zhrnutím a referenciou FHIR; filtrovanie pomocou `from`, `to`, `types` |
| Kompletný záznam ako FHIR | `GET /fhir/R4/Patient/{id}/$everything` | Searchset Bundle; podporované sú `_since`, `_type`, `_count` a `_offset` |
| Zdieľateľné klinické zhrnutie | `GET /fhir/R4/Patient/{id}/$summary` | Dokument International Patient Summary (IPS) |
| Vstup pre AI model | `POST /v1/context` | Sekcie v rámci rozpočtu tokenov, každý fakt označený svojím zdrojom |

Časová os 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 ten istý záznam ako FHIR, obmedzený na to, čo sa zmenilo od dátumu:

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

## Udržiavanie synchronizácie vašej kópie

Ak vaša aplikácia udržiava vlastný pohľad na históriu, prihláste sa na odber webhookov `resource.created`, `resource.updated` a `resource.deleted`. Tieto sa spustia aj vtedy, keď iný projekt zapíše do záznamu, ku ktorému máte prístup, s `data.external: true` a zapisovateľom v `data.source`, takže sa k vám údaje z iných kliník dostanú bez nutnosti opakovaného dopytovania.

## Limity, ktoré sa oplatí vedieť

- Záznam obsahuje to, čo bolo doň zapísané. Anpheros si sám nesťahuje históriu z nemocníc ani národných sietí; zapisujú ju kliniky, laboratóriá, aplikácie a samotná osoba.
- Ukladá sa 26 typov zdrojov FHIR R4. Zdroje fakturácie, ako napríklad Claim a ExplanationOfBenefit, sa neukladajú.
- Iné aplikácie čítajú históriu osoby iba s jej súhlasom; vlastný kľúč projektu vidí pacientov, ktorých vytvoril.

## Často kladené otázky

### Čo sú longitudinálne údaje o pacientovi?
Zdravotné informácie osoby zhromaždené v priebehu času a naprieč poskytovateľmi zdravotnej starostlivosti — diagnózy, lieky, výsledky, vitálne funkcie, očkovania a návštevy — uchovávané tak, aby sa dali čítať ako jedna súvislá história.

### Ktoré API poskytuje chronologický pohľad na záznam pacienta?
V Anpheros, `GET /v1/patients/{id}/timeline` vracia záznamy z ôsmich typov zdrojov v chronologickom poradí, s stránkovaním a filtrami podľa dátumu a typu. Pre úplné FHIR dáta použite `Patient/$everything`.

### Je história uložená v štandardnom formáte?
Áno. Každý záznam je HL7 FHIR R4 zdroj so štandardnými kódmi (LOINC, ICD-10, ATC, CVX, UCUM) a súhrn je International Patient Summary.

### Ako zistím, kto vytvoril každý záznam?
Každé zapísanie vytvorí zdroj Provenance s typom autora (pacient, lekár, zariadenie, import alebo AI), osobou, organizáciou a zdrojovým systémom.

### Môžem testovať s realistickými longitudinálnymi údajmi?
Áno. Každý sandbox projekt začína s 30 syntetickými pacientmi s približne šiestimi mesiacmi stavov, liekov, laboratórnych výsledkov a vitálnych funkcií.

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

## Súvisiace

- [Aplikácia osobného zdravotného záznamu (PHR) s FHIR](https://developers.anpheros.com/sk/guides/personal-health-record-app): časová os v reálnej aplikácii
- [Vysvetlenie pôvodu lekárskych údajov](https://developers.anpheros.com/sk/guides/medical-data-provenance)
- [Platforma súhlasu pacienta pre zdravotné aplikácie](https://developers.anpheros.com/sk/guides/patient-consent-platform)
- [Ako ukladať lekárske záznamy pomocou FHIR R4](https://developers.anpheros.com/sk/guides/store-medical-records-fhir)
- [AI agenti a lekárske údaje](https://developers.anpheros.com/sk/guides/ai-agents-medical-data): koncový bod kontextu
- [Webhooks](https://developers.anpheros.com/sk/guides/webhooks)