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

API date longitudinale ale pacientului

Q: Ce API oferă o vizualizare cronologică a dosarului unui pacient?

În Anpheros, GET /v1/patients/{id}/timeline returnează intrări din opt tipuri de resurse în ordinea datei, cu paginare și filtre de dată și tip. Pentru datele FHIR complete, utilizați Patient/$everything.

Istoricul unui pacient în timp de la clinici, laboratoare, aplicații și dispozitive: ce necesită un dosar longitudinal și patru moduri de a-l citi — cronologie, $everything, IPS și context AI.

Un API pentru date longitudinale ale pacienților returnează istoricul de sănătate al unei persoane în timp — diagnostice, medicamente, rezultate de laborator, semne vitale, vaccinări și vizite de la fiecare sursă — ca un singur istoric ordonat, în loc de documente separate per furnizor. Anpheros păstrează acest istoric ca un singur record HL7 FHIR R4 per pacient, scris de clinici, laboratoare, aplicații și dispozitive, păstrând fiecare versiune și fiecare autor. Dezvoltatorii îl citesc în patru moduri: o cronologie, recordul FHIR complet cu Patient/$everything, un Rezumat Internațional al Pacientului (IPS) sau un context compact pentru modele 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

Ce presupune „longitudinal”

O listă de rezultate nu este încă un istoric longitudinal. Pentru ca o aplicație să aibă încredere într-un istoric care acoperă ani și furnizori, fiecare înregistrare trebuie să conțină:

Cerință	De ce este importantă	Cum o stochează Anpheros
Un sens codificat	Valorile de la laboratoare diferite trebuie să fie comparabile	LOINC pentru rezultate, ICD-10 pentru afecțiuni, ATC pentru medicamente
O dată clinică	Ordonare după momentul în care s-a întâmplat, nu după momentul încărcării	`effective`, `onset`, `occurrence` date pe fiecare resursă
Autorul	Diagnosticul unui medic și nota unui pacient nu sunt egale	Proveniență la fiecare scriere: tipul autorului, persoana, organizația, sistemul sursă
Fiecare versiune	Corecțiile nu trebuie să șteargă ceea ce era cunoscut anterior	Istoric de versiuni pe fiecare resursă (`_history`)
Consimțământ	Alte aplicații văd istoricul doar dacă persoana este de acord	Granturi OAuth cu scopuri, expirare și un jurnal de acces

Un singur record, mai mulți autori

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

Patru moduri de a citi istoricul

Nevoie	Endpoint	Ce obțineți
Un flux cronologic pentru un ecran	`GET /v1/patients/{id}/timeline`	Elemente de opt tipuri (observation, condition, medication, document, encounter, appointment, immunization, episode) cu dată, titlu, rezumat și referința FHIR; filtrați cu `from`, `to`, `types`
Înregistrarea completă ca FHIR	`GET /fhir/R4/Patient/{id}/$everything`	Un Bundle de tip searchset; `_since`, `_type`, `_count` și `_offset` sunt suportate
Un rezumat clinic partajabil	`GET /fhir/R4/Patient/{id}/$summary`	Un document International Patient Summary (IPS)
Intrare pentru un model AI	`POST /v1/context`	Secțiuni în cadrul unui buget de tokeni, fiecare fapt etichetat cu sursa sa

Cronologia cu SDK-ul TypeScript:

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 aceeași înregistrare ca FHIR, limitată la ce s-a schimbat de la o anumită dată:

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

Păstrarea datelor în sincronizare

Dacă aplicația dvs. își păstrează propria vizualizare a istoricului, abonați-vă la webhooks resource.created, resource.updated și resource.deleted. Acestea se declanșează și atunci când un alt proiect scrie într-un înregistrare la care aveți acces, cu data.external: true și autorul în data.source, astfel încât datele de la alte clinici să ajungă la dvs. fără a fi necesară interogarea periodică.

Limite de reținut

Înregistrarea conține ceea ce a fost scris în ea. Anpheros nu preia istoricul de la spitale sau rețele naționale de la sine; clinici, laboratoare, aplicații și persoana în cauză o scriu.
Sunt stocate 26 de tipuri de resurse FHIR R4. Resursele de facturare, cum ar fi Claim și ExplanationOfBenefit, nu sunt.
Alte aplicații citesc istoricul unei persoane doar cu consimțământul acelei persoane; cheia proprie a unui proiect vede pacienții pe care i-a creat.

Întrebări frecvente

Ce sunt datele longitudinale ale pacienților?

Informațiile despre sănătatea unei persoane colectate în timp și în diverse medii de îngrijire — diagnostice, medicamente, rezultate, semne vitale, vaccinări și vizite — păstrate astfel încât să poată fi citite ca un istoric continuu.

Ce API oferă o vizualizare cronologică a dosarului unui pacient?

În Anpheros, GET /v1/patients/{id}/timeline returnează intrări din opt tipuri de resurse în ordinea datei, cu paginare și filtre de dată și tip. Pentru datele FHIR complete, utilizați Patient/$everything.

Istoricul este stocat într-un format standard?

Da. Fiecare intrare este o resursă HL7 FHIR R4 cu coduri standard (LOINC, ICD-10, ATC, CVX, UCUM), iar rezumatul este un International Patient Summary.

Cum știu cine a scris fiecare intrare?

Fiecare scriere creează o resursă Provenance cu tipul autorului (pacient, practician, dispozitiv, import sau AI), persoana, organizația și sistemul sursă.

Pot testa cu date longitudinale realiste?

Da. Fiecare proiect sandbox începe cu 30 de pacienți sintetici cu aproximativ șase luni de afecțiuni, medicamente, rezultate de laborator și semne vitale.

Legate de acest subiect

Aplicație de dosar personal de sănătate (PHR) cu FHIR: o cronologie într-o aplicație reală
Proveniența datelor medicale explicată
Platformă de consimțământ al pacientului pentru aplicații de sănătate
Cum să stocați înregistrări medicale utilizând FHIR R4
Agenți AI și date medicale: endpoint-ul de context
Webhooks

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