Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
API danych longitudinalnych pacjenta
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.
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.
- 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 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
- 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
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:
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:
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.
Powiązane
- Aplikacja osobistego rekordu zdrowia (PHR) z wykorzystaniem FHIR: oś czasu w rzeczywistej aplikacji
- Wyjaśnienie pochodzenia danych medycznych
- Platforma zgody pacjenta dla aplikacji zdrowotnych
- Jak przechowywać dokumentację medyczną przy użyciu FHIR R4
- Agenci AI i dane medyczne: punkt końcowy kontekstu
- Webhooks
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card