Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

API pro longitudinální data pacienta

Q: 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.

Historie jednoho pacienta v čase z klinik, laboratoří, aplikací a zařízení: co longitudinální záznam potřebuje a čtyři způsoby jeho čtení — časová osa, $everything, IPS a kontext AI.

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.

Many sources, one longitudinal record

ClinicsVisits, diagnoses and prescriptions as FHIR R4
LaboratoriesHL7 v2, CSV or JSON reports become Observations
Apps and devicesReadings from phones, watches and home devices
One FHIR recordEvery version kept, every write with provenance
Your applicationTimeline, $everything, IPS summary or AI context

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ů

One patient, many writers, one timeline (illustrative data)

Mar 2019Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
Mar 2019Metformin 500 mgMedicationStatement · ATC A10BA02
Sep 2023HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
Oct 2024Influenza vaccineImmunization · written by the pharmacy
Jun 2026Cardiology visitEncounter · written by the clinic
Oct 2026Blood pressure 138/86 mmHgObservation · from the patient's app

Condition Medication Observation Immunization Encounter

Č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:

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:

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í.

Související

Aplikace osobního zdravotního záznamu (PHR) s FHIR: časová osa v reálné aplikaci
Vysvětlení původu lékařských dat
Platforma pro souhlas pacienta pro zdravotnické aplikace
Jak ukládat lékařské záznamy pomocí FHIR R4
AI agenti a lékařská data: koncový bod kontextu
Webhooks

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card