# Platformă FHIR: FHIR R4 gestionat cu consimțământul pacientului

> O platformă FHIR R4 gestionată: 26 de tipuri de resurse, căutare, istoric, tranzacții, $everything, IPS, lansare SMART testată Inferno, consimțământ și proveniență, plus o API REST simplă. Sandbox gratuit.

Source: https://developers.anpheros.com/ro/guides/fhir

**Anpheros este o platformă FHIR — o bază de date FHIR gestionată (depozit de date) pe care aplicațiile o folosesc ca backend FHIR: stochează fiecare înregistrare a pacientului nativ ca resurse HL7 FHIR R4 (4.0.1) și le expune la `https://platform.anpheros.com/fhir/R4`,** cu consimțământ, proveniență și audit adăugate peste standard. Aplicațiile care deja folosesc FHIR îl pot utiliza direct; aplicațiile care nu o fac pot utiliza API-ul REST mai simplu (`/v1`), care citește și scrie aceleași resurse cu aceleași ID-uri.

Pentru aplicațiile AI, acest lucru face din Anpheros backend-ul FHIR din care provine contextul unui model: vezi [Aplicații LLM și date medicale](https://developers.anpheros.com/ro/guides/llm-healthcare-data).

<!-- visual:fhir-hero -->

## Ce este HL7 FHIR?

FHIR (Fast Healthcare Interoperability Resources) este standardul HL7 pentru schimbul de date medicale pe web. Acesta definește:

- **resurse** — documente JSON (sau XML) mici, tipizate, pentru fiecare concept clinic: un `Patient`, un `Observation`, un `Condition`, un `MedicationStatement`;
- **referințe** între ele (`"subject": {"reference": "Patient/123"}`), astfel încât un fișier este un graf de resurse centrat pe un pacient;
- un **API REST** pentru citirea, căutarea, crearea, actualizarea și ștergerea resurselor, cu parametri de căutare standard;
- **pachete (bundles)** pentru trimiterea mai multor resurse simultan (tranzacții) sau ca un document (cum ar fi un rezumat al pacientului);
- **legături de terminologie (terminology bindings)**, astfel încât valorile să poarte coduri din sisteme precum LOINC sau ICD-10;
- **profiluri (profiles)** — constrângeri pentru un caz de utilizare sau o țară, cum ar fi International Patient Summary.

R4 (versiunea 4.0.1) este versiunea cea mai implementată astăzi. Utilizarea FHIR ca model de stocare — nu doar ca format de export — înseamnă că nu există un strat de translatare între ceea ce scrie o aplicație și ceea ce citește un alt sistem FHIR.

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "4548-4", "display": "Hemoglobin A1c"}]},
  "subject": {"reference": "Patient/…"},
  "effectiveDateTime": "2026-09-01T08:00:00Z",
  "valueQuantity": {"value": 6.4, "unit": "%", "system": "http://unitsofmeasure.org", "code": "%"}
}
```

## Declarație de capabilități

`GET /fhir/R4/metadata` returnează CapabilityStatement: tipurile de resurse suportate, parametrii lor de căutare și operațiunile. Este publică și reprezintă lista autorizată; tabelul de mai jos o reflectă la data de 28 septembrie 2026.

## Cele 26 de tipuri de resurse

<!-- visual:fhir-map:replace -->

| Domeniu | Tipuri de resurse |
|---|---|
| Pacient și persoane | `Patient`, `RelatedPerson` |
| Măsurători și rezultate | `Observation` (semne vitale, laborator, simptome, stare de bine, activitate zilnică și somn), `DiagnosticReport` |
| Probleme și îngrijire | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| Medicamente și prevenție | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Documente și chestionare | `DocumentReference`, `QuestionnaireResponse` |
| Vizite | `Encounter`, `Appointment` |
| Director | `Organization`, `Practitioner`, `PractitionerRole` |
| Guvernanță | `Consent`, `Provenance` |
| Punct de extensie | `Basic` |

Fiecare tip de resursă la nivel de pacient aparține compartimentului pacientului, astfel încât `Patient/{id}/$everything`, scopurile OAuth la nivel de pacient și filtrele de consimțământ se aplică tuturor acestora. Resursele de director (`Organization`, `Practitioner`, `PractitionerRole`) nu au pacient; acestea sunt citibile în toate proiectele din același mediu și modificabile doar de către proiectul care le-a creat.

## Interacțiuni și operațiuni

<!-- visual:fhir-ops -->

- **Read, search, create, update, delete** pe fiecare tip suportat; parametrii de căutare per tip sunt listați în CapabilityStatement. Parametrii de căutare necunoscuți sunt refuzați cu `400` în loc să fie ignorați silențios.
- **History**: `GET /fhir/R4/{type}/{id}/_history` returnează fiecare versiune; actualizările pot fi condiționate cu `If-Match` (o nepotrivire de versiune răspunde cu `412`).
- **Transactions and batches**: `POST /fhir/R4` cu un `Bundle` de tip `transaction` sau `batch`.
- **`Patient/{id}/$everything`**: întregul compartiment al unui pacient.
- **`Patient/{id}/$summary`**: un document International Patient Summary (IPS) `Bundle`, în engleză sau română (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: raportează cum se compară un rezultat de laborator cu regulile de raportare de laborator HL7 Europe.
- **Paging**: `_count` până la 200; `_revinclude` returnează maximum 1 000 de resurse.
- **Idempotency**: `POST` requests acceptă un `Idempotency-Key`; repetarea unei cereri cu aceeași cheie returnează același răspuns și nu creează nimic.

```bash
# latest HbA1c results of one patient, strict FHIR
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" \
     -H "Authorization: Bearer $KEY"

# the patient's International Patient Summary
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" -H "Authorization: Bearer $KEY"
```

## FHIR și API-ul REST mai simplu

`/v1` există pentru dezvoltatorii care nu doresc să lucreze direct cu resursele FHIR. Acesta acoperă pacienți, observații, condiții, medicamente, documente, o cronologie și proveniență, plus caracteristicile platformei (context, import laborator, webhooks, terminologie). Fiecare obiect `/v1` poartă referința sa `fhir`, astfel încât o aplicație poate începe cu `/v1` și poate comuta la FHIR pentru părțile unde necesită modelul complet.

## Standarde în jurul FHIR

`$summary` produce un International Patient Summary validat cu validatorul oficial HL7 (0 erori); rezultatele de laborator sunt verificate conform regulilor de laborator HL7 Europe (în prezent consultative); aplicațiile terțe se conectează prin SMART on FHIR standalone launch; mesajele de laborator HL7 v2 `ORU^R01` sunt acceptate ca intrare. Formatele, nivelurile și modelele de schimb sunt descrise în [Interoperabilitatea datelor din domeniul sănătății](https://developers.anpheros.com/ro/guides/interoperability); sistemele de coduri pe tip de resursă în [Sisteme de coduri FHIR](https://developers.anpheros.com/ro/guides/fhir-code-systems).

## Întrebări frecvente

### Ce este o platformă FHIR?
Un serviciu care stochează date medicale sub formă de resurse HL7 FHIR și le expune prin intermediul API-ului REST FHIR standard, adăugând ceea ce aplicațiile necesită în jurul standardului: autorizare, consimțământ, audit, istoric și operațiuni precum `$everything` și `$summary`. Anpheros este o platformă FHIR R4 gestionată: o apelați în loc să rulați un server FHIR.

### Care este diferența dintre un server FHIR și o platformă FHIR?
Un server FHIR implementează API-ul FHIR peste o bază de date. O platformă FHIR îl rulează pentru dumneavoastră și adaugă stratul din jurul acestuia — consimțământul pacientului, proveniența, jurnalele de acces, SDK-urile, webhook-urile, importul de laborator și un sandbox — astfel încât aplicațiile să nu fie nevoite să construiască acele părți.

### Ce versiune FHIR suportă Anpheros?
FHIR R4 (4.0.1), cu 26 de tipuri de resurse listate în CapabilityStatement public la `/fhir/R4/metadata`.

### Este platforma Anpheros FHIR testată independent?
Grupul SMART App Launch STU2 "Standalone Launch" al kitului de testare open-source Inferno trece 22 din 22 de teste (rulare din 28 septembrie 2026), iar International Patient Summary se validează cu 0 erori în validatorul oficial HL7. Lansarea EHR și exportul de date în masă nu sunt încă suportate.

### Pot folosi platforma FHIR gratuit?
Da. Sandbox-ul este gratuit și include 30 de pacienți sintetici per proiect; producția începe de la 99 € pe lună, cu prima lună gratuită.

### Trebuie să folosesc FHIR pentru a folosi Anpheros?
Nu. Un API REST mai simplu (`/v1`) citește și scrie aceleași resurse cu aceleași ID-uri, astfel încât o aplicație poate începe cu JSON plat și poate trece la FHIR acolo unde necesită modelul complet.

<!-- visual:cta-fhir -->

## Conexe

- [FHIR sandbox](https://developers.anpheros.com/ro/guides/fhir-sandbox): un server privat gratuit de testare FHIR R4
- [International Patient Summary (IPS) în FHIR](https://developers.anpheros.com/ro/guides/international-patient-summary-fhir)
- [Proveniența datelor medicale explicată](https://developers.anpheros.com/ro/guides/medical-data-provenance): cine a scris ce și cum să o înregistrați
- [Cum să stocați înregistrări medicale folosind FHIR R4](https://developers.anpheros.com/ro/guides/store-medical-records-fhir): tutorial pas cu pas cu curl
- [FHIR vs. o bază de date medicală personalizată](https://developers.anpheros.com/ro/guides/fhir-vs-custom-database): când să vă proiectați propriile tabele și când să folosiți FHIR
- [Bază de date și sandbox FHIR gratuite](https://developers.anpheros.com/ro/guides/free-fhir-database)
- [Cum se compară Anpheros cu alte servere FHIR](https://developers.anpheros.com/ro/guides/fhir-server-comparison)
- [Interoperabilitatea datelor din domeniul sănătății](https://developers.anpheros.com/ro/guides/interoperability)
- [Sisteme de coduri FHIR](https://developers.anpheros.com/ro/guides/fhir-code-systems)
- [API pentru date medicale](https://developers.anpheros.com/ro/guides/medical-data-api)
- [Construiți o aplicație pentru domeniul sănătății](https://developers.anpheros.com/ro/guides/build-a-healthcare-app)
- [Referință API (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM vs FHIR](https://developers.anpheros.com/ro/guides/dicom-vs-fhir): unde se termină FHIR și unde începe imagistica medicală