# API danych pacjenta w czasie

> Historia jednego pacjenta w czasie z przychodni, laboratoriów, aplikacji i urządzeń: czego potrzebuje rekord longitudinalny i cztery sposoby jego odczytu — oś czasu, $everything, IPS i kontekst AI.

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

**API danych pacjenta w czasie zwraca historię zdrowia jednej osoby w czasie — diagnozy, leki, wyniki badań laboratoryjnych, parametry życiowe, szczepienia i wizyty z każdego źródła — jako jeden uporządkowany rekord zamiast oddzielnych dokumentów na dostawcę.** Anpheros przechowuje tę historię jako pojedynczy rekord HL7 FHIR R4 na pacjenta, zapisywany przez przychodnie, laboratoria, aplikacje i urządzenia, z zachowaniem każdej wersji i każdego autora. Deweloperzy odczytują go na cztery sposoby: chronologiczna oś czasu, pełny rekord FHIR z `Patient/$everything`, Międzynarodowe Podsumowanie Pacjenta lub skondensowany kontekst dla modeli AI.

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

## Co oznacza „longitudinal”

Lista wyników nie jest jeszcze zapisem longitudinalnym. Aby aplikacja mogła zaufać historii obejmującej lata i wielu dostawców, każdy wpis musi zawierać:

| Wymaganie | Dlaczego jest ważne | Jak Anpheros to przechowuje |
|---|---|---|
| Zakodowane znaczenie | Wartości z różnych laboratoriów muszą być porównywalne | LOINC dla wyników, ICD-10 dla schorzeń, ATC dla leków |
| Data kliniczna | Sortowanie według daty zdarzenia, a nie daty przesłania | daty `effective`, `onset`, `occurrence` w każdym zasobie |
| Autor | Diagnoza lekarza i notatka pacjenta nie są tym samym | Provenance przy każdym zapisie: typ autora, osoba, organizacja, system źródłowy |
| Każda wersja | Korekty nie mogą usuwać tego, co było wcześniej znane | Historia wersji w każdym zasobie (`_history`) |
| Zgoda | Inne aplikacje widzą historię tylko wtedy, gdy osoba wyrazi zgodę | Granty OAuth ze zakresami, datą wygaśnięcia i dziennikiem dostępu |

## Jeden rekord, wielu autorów

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

## Cztery sposoby odczytu historii

| Potrzeba | Endpoint | Co otrzymujesz |
|---|---|---|
| Chronologiczny strumień dla ekranu | `GET /v1/patients/{id}/timeline` | Elementy ośmiu typów (obserwacja, stan, lek, dokument, wizyta, spotkanie, szczepienie, epizod) z datą, tytułem, podsumowaniem i referencją FHIR; filtrowanie za pomocą `from`, `to`, `types` |
| Kompletny rekord jako FHIR | `GET /fhir/R4/Patient/{id}/$everything` | Bundle typu searchset; obsługiwane są `_since`, `_type`, `_count` i `_offset` |
| Udostępniany podsumowanie kliniczne | `GET /fhir/R4/Patient/{id}/$summary` | Dokument International Patient Summary (IPS) |
| Wejście dla modelu AI | `POST /v1/context` | Sekcje w ramach budżetu tokenów, każdy fakt opatrzony etykietą ze źródłem |

Oś czasu z 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);
```

I ten sam rekord jako FHIR, ograniczony do tego, co zmieniło się od daty:

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

## Utrzymywanie synchronizacji kopii danych

Jeśli Twoja aplikacja przechowuje własny widok historii, zasubskrybuj webhooki `resource.created`, `resource.updated` i `resource.deleted`. Są one również wywoływane, gdy inny projekt zapisuje dane w rekordzie, do którego masz dostęp, z informacją o `data.external: true` i autorze w `data.source`, dzięki czemu dane z innych klinik docierają do Ciebie bez konieczności odpytywania.

## Limity, o których warto wiedzieć

- Rekord zawiera to, co zostało do niego zapisane. Anpheros samodzielnie nie pobiera historii z placówek medycznych ani sieci krajowych; zapisują ją kliniki, laboratoria, aplikacje i sam pacjent.
- Przechowywane są 26 typy zasobów FHIR R4. Zasoby rozliczeniowe, takie jak Claim i ExplanationOfBenefit, nie są przechowywane.
- Inne aplikacje odczytują historię pacjenta tylko za jego zgodą; klucz własnego projektu widzi pacjentów, których utworzył.

## Często zadawane pytania

### Czym są dane longitudinalne pacjenta?
Informacje o stanie zdrowia osoby zebrane w czasie i w różnych placówkach opieki — diagnozy, leki, wyniki badań, parametry życiowe, szczepienia i wizyty — przechowywane w taki sposób, aby można je było odczytać jako jedną ciągłą historię.

### Które API zapewnia chronologiczny widok dokumentacji pacjenta?
W Anpheros, `GET /v1/patients/{id}/timeline` zwraca wpisy z ośmiu typów zasobów w kolejności dat, z możliwością stronicowania oraz filtrowania według daty i typu. Pełne dane FHIR znajdują się w `Patient/$everything`.

### Czy historia jest przechowywana w standardowym formacie?
Tak. Każdy wpis jest zasobem HL7 FHIR R4 ze standardowymi kodami (LOINC, ICD-10, ATC, CVX, UCUM), a podsumowanie stanowi International Patient Summary.

### Skąd mam wiedzieć, kto napisał każdy wpis?
Każde zapisanie tworzy zasób Provenance z typem autora (pacjent, praktykujący lekarz, urządzenie, import lub AI), osobą, organizacją i systemem źródłowym.

### Czy mogę testować z realistycznymi danymi longitudinalnymi?
Tak. Każdy projekt sandbox zaczyna się z 30 syntetycznymi pacjentami, posiadającymi około sześciomiesięczne dane dotyczące schorzeń, leków, wyników laboratoryjnych i parametrów życiowych.

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

## Powiązane

- [Aplikacja osobistego rekordu zdrowia (PHR) z wykorzystaniem FHIR](https://developers.anpheros.com/pl/guides/personal-health-record-app): oś czasu w rzeczywistej aplikacji
- [Wyjaśnienie pochodzenia danych medycznych](https://developers.anpheros.com/pl/guides/medical-data-provenance)
- [Platforma zgody pacjenta dla aplikacji zdrowotnych](https://developers.anpheros.com/pl/guides/patient-consent-platform)
- [Jak przechowywać dokumentację medyczną przy użyciu FHIR R4](https://developers.anpheros.com/pl/guides/store-medical-records-fhir)
- [Agenci AI i dane medyczne](https://developers.anpheros.com/pl/guides/ai-agents-medical-data): punkt końcowy kontekstu
- [Webhooks](https://developers.anpheros.com/pl/guides/webhooks)