# Hosszantiális betegadat API

> Egy beteg története az idők során klinikákról, laborokból, alkalmazásokból és eszközökből: mit igényel egy hosszantiális rekord, és négyféleképpen olvasható – idővonal, $everything, IPS és AI kontextus.

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

**Egy hosszantiális betegadat API egy személy egészségtörténetét adja vissza az idők során – diagnózisok, gyógyszerek, laboreredmények, életjelek, oltások és látogatások minden forrásból – egyetlen rendezett rekordként, nem pedig külön dokumentumokként szolgáltatónként.** Az Anpheros ezt a történetet betegként egyetlen HL7 FHIR R4 rekordként tárolja, amelyet klinikák, laboratóriumok, alkalmazások és eszközök írnak, minden verziót és minden szerzőt megőrizve. A fejlesztők négyféleképpen olvashatják: kronológiai idővonalon, a teljes FHIR rekorddal `Patient/$everything`, egy Nemzetközi Betegösszefoglalóval (International Patient Summary), vagy egy kompakt kontextussal az AI modellek számára.

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

## Mit igényel a „hosszanti”

Az eredmények listája önmagában még nem hosszanti rekord. Ahhoz, hogy egy alkalmazás megbízhasson több éves és több szolgáltatót átfogó előzményekben, minden bejegyzésnek tartalmaznia kell:

| Követelmény | Miért fontos | Hogyan tárolja az Anpheros |
|---|---|---|
| Kódolt jelentés | A különböző laborok értékeinek összehasonlíthatónak kell lenniük | LOINC az eredményekhez, ICD-10 a feltételekhez, ATC a gyógyszerekhez |
| Klinikai dátum | A történtek szerinti rendezés, nem az feltöltés dátuma szerint | `effective`, `onset`, `occurrence` dátumok minden erőforráson |
| A szerző | Az orvos diagnózisa és a beteg megjegyzése nem egyenlő | Provenance minden írásnál: szerző típusa, személy, szervezet, forrásrendszer |
| Minden verzió | A javítások nem törölhetik el, ami korábban ismert volt | Verziótörténet minden erőforráson (`_history`) |
| Hozzájárulás | Más alkalmazások csak akkor láthatják az előzményeket, ha a személy beleegyezik | OAuth engedélyek hatókörökkel, lejárattal és hozzáférési naplóval |

## Egy rekord, több író

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

## Négy mód a történet olvasására

| Szükséglet | Végpont | Mit kap |
|---|---|---|
| Kronologikus hírcsatorna egy képernyőhöz | `GET /v1/patients/{id}/timeline` | Nyolc típusú elem (megfigyelés, állapot, gyógyszer, dokumentum, találkozó, időpont, oltás, epizód) dátummal, címmel, összefoglalóval és a FHIR referenciával; szűrés `from`, `to`, `types` használatával |
| A teljes rekord FHIR formátumban | `GET /fhir/R4/Patient/{id}/$everything` | Egy searchset Bundle; `_since`, `_type`, `_count` és `_offset` támogatott |
| Megosztható klinikai összefoglaló | `GET /fhir/R4/Patient/{id}/$summary` | Egy International Patient Summary (IPS) dokumentum |
| Bemenet egy AI modellhez | `POST /v1/context` | Szakaszok egy token-kereten belül, minden tény forrásával címkézve |

Az idővonal a TypeScript SDK-val:

```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);
```

És ugyanaz a rekord FHIR formátumban, korlátozva arra, ami egy dátum óta változott:

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

## A másolat szinkronban tartása

Ha az alkalmazása saját nézetet tart fenn az előzményekről, iratkozzon fel a `resource.created`, `resource.updated` és `resource.deleted` webhookokra. Ezek akkor is aktiválódnak, ha egy másik projekt ír egy olyan rekordba, amelyhez hozzáférése van, a `data.external: true` és a `data.source` íróval, így az adatok más klinikákról is eljutnak Önhöz lekérdezés nélkül.

## Figyelembe veendő korlátok

- A rekord tartalmazza, amit beleírtak. Az Anpheros nem tölt le történelmi adatokat kórházakból vagy nemzeti hálózatokból önállóan; a klinikák, laborok, alkalmazások és a személy írják bele.
- 26 FHIR R4 erőforrás típus tárolódik. A számlázási erőforrások, mint például a Claim és az ExplanationOfBenefit, nem.
- Más alkalmazások csak az adott személy beleegyezésével olvashatják a személy előzményeit; egy projekt saját kulcsa látja az általa létrehozott betegeket.

## Gyakran ismételt kérdések

### Mi a longitudinális betegadat?
Egy személy egészségügyi információi, amelyeket idővel és különböző ellátási helyszíneken gyűjtöttek össze – diagnózisok, gyógyszerek, eredmények, életjelek, oltások és látogatások –, megőrizve, hogy egyetlen folyamatos történetként lehessen olvasni.

### Melyik API ad kronologikus nézetet egy beteg rekordjáról?
Az Anpherosban a `GET /v1/patients/{id}/timeline` nyolc erőforrás típusból származó bejegyzéseket ad vissza dátumrendben, lapozással, valamint dátum- és típus szűrőkkel. A teljes FHIR adatokhoz használja a `Patient/$everything`.

### A történet szabványos formátumban van tárolva?
Igen. Minden bejegyzés egy HL7 FHIR R4 erőforrás szabványos kódokkal (LOINC, ICD-10, ATC, CVX, UCUM), és az összefoglaló egy International Patient Summary.

### Honnan tudom, ki írta az egyes bejegyzéseket?
Minden írás létrehoz egy Provenance erőforrást a szerző típusával (beteg, gyakorló, eszköz, import vagy AI), a személlyel, a szervezettel és a forrásrendszerrel.

### Tesztelhetek valósághű longitudinális adatokkal?
Igen. Minden sandbox projekt 30 szintetikus beteggel indul, körülbelül hat hónapnyi állapotokkal, gyógyszerekkel, laboratóriumi eredményekkel és életjelekkel.

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

## Kapcsolódó

- [Személyes egészségügyi nyilvántartást (PHR) kezelő alkalmazás FHIR-rel](https://developers.anpheros.com/hu/guides/personal-health-record-app): idővonal egy valós alkalmazásban
- [Az orvosi adatok eredetének magyarázata](https://developers.anpheros.com/hu/guides/medical-data-provenance)
- [Beteg beleegyezési platform egészségügyi alkalmazásokhoz](https://developers.anpheros.com/hu/guides/patient-consent-platform)
- [Orvosi nyilvántartások tárolása FHIR R4 segítségével](https://developers.anpheros.com/hu/guides/store-medical-records-fhir)
- [AI ügynökök és orvosi adatok](https://developers.anpheros.com/hu/guides/ai-agents-medical-data): a kontextus végpont
- [Webhookok](https://developers.anpheros.com/hu/guides/webhooks)