Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
API pre longitudinálne údaje pacienta
História jedného pacienta v priebehu času z kliník, laboratórií, aplikácií a zariadení: čo potrebuje longitudinálny záznam a štyri spôsoby jeho čítania — časová os, $everything, IPS a kontext AI.
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.
- 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
Č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
- Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
- Metformin 500 mgMedicationStatement · ATC A10BA02
- HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
- Influenza vaccineImmunization · written by the pharmacy
- Cardiology visitEncounter · written by the clinic
- Blood pressure 138/86 mmHgObservation · from the patient's app
Condition Medication Observation Immunization Encounter
Š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:
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:
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í.
Súvisiace
- Aplikácia osobného zdravotného záznamu (PHR) s FHIR: časová os v reálnej aplikácii
- Vysvetlenie pôvodu lekárskych údajov
- Platforma súhlasu pacienta pre zdravotné aplikácie
- Ako ukladať lekárske záznamy pomocou FHIR R4
- AI agenti a lekárske údaje: koncový bod kontextu
- Webhooks
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card