# API pentru date longitudinale ale pacienților

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

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

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

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

## 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

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

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

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

```bash
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.

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

## Legate de acest subiect

- [Aplicație de dosar personal de sănătate (PHR) cu FHIR](https://developers.anpheros.com/ro/guides/personal-health-record-app): o cronologie într-o aplicație reală
- [Proveniența datelor medicale explicată](https://developers.anpheros.com/ro/guides/medical-data-provenance)
- [Platformă de consimțământ al pacientului pentru aplicații de sănătate](https://developers.anpheros.com/ro/guides/patient-consent-platform)
- [Cum să stocați înregistrări medicale utilizând FHIR R4](https://developers.anpheros.com/ro/guides/store-medical-records-fhir)
- [Agenți AI și date medicale](https://developers.anpheros.com/ro/guides/ai-agents-medical-data): endpoint-ul de context
- [Webhooks](https://developers.anpheros.com/ro/guides/webhooks)