# API pentru Sănătate: ce este și cum funcționează

> Ce este o API pentru sănătate, cum funcționează un apel, la ce să fiți atenți și o API gratuită FHIR R4 pentru sănătate cu consimțământul pacientului, proveniența datelor și găzduire în UE — cu exemple și Întrebări Frecvente.

Source: https://developers.anpheros.com/ro/guides/healthcare-api

**O API pentru sănătate este o interfață programatică prin care software-ul citește și scrie date medicale — fișe medicale ale pacienților, observații, diagnostice, medicamente, documente — și prin care este autorizată accesarea acestor date.** API-ul Anpheros Platform este o API pentru sănătate peste un dosar HL7 FHIR R4 controlat de pacient: aplicațiile îl folosesc pentru a stoca și prelua date medicale, pentru a obține consimțământul unui pacient și pentru a fi notificate cu privire la modificări.

<!-- visual: hapi-hero -->

## Cum funcționează un apel API de sănătate

Indiferent de furnizor, un apel API de sănătate trece prin aceleași puncte de control: cine apelează, ce pacient și ce date poate accesa, unde sunt stocate datele, cine le-a scris și cine trebuie să știe că s-au modificat.

<!-- visual: hapi-request -->

## Tipuri de API-uri pentru sănătate

| Tip | Ce schimbă | Utilizare tipică |
|---|---|---|
| API-uri FHIR REST | Resurse FHIR peste HTTP (`GET /Observation?patient=…`) | standardul modern pentru schimbul de date clinice |
| SMART on FHIR / OAuth | autorizare pentru API-uri FHIR | permiterea aplicațiilor terțe să acceseze un dosar cu permisiunea utilizatorului |
| Mesagerie HL7 v2 | mesaje delimitate prin pipe (`ORU^R01` pentru rezultate, `ADT` pentru internări) | sisteme de laborator și spitalicești, adesea prin interfețe, mai degrabă decât HTTP |
| Schimb de documente | documente clinice (PDF, CDA, bundle-uri de documente FHIR) | rezumate, scrisori de externare, trimiteri |
| API-uri REST proprietare | JSON specific vendor-ului | aplicația mobilă a unui singur produs sau integrări |

Anpheros combină primele două ca nucleu, acceptă rezultate de laborator HL7 v2 ca intrare, stochează documente cu originalele lor și produce bundle-uri de documente FHIR (International Patient Summary). De asemenea, oferă un API REST mai simplu peste aceleași date pentru dezvoltatorii care nu doresc să lucreze direct cu FHIR.

## Ce să căutați într-un API de sănătate

<!-- visual:hapi-checklist:replace -->

- **Un model de date standard**, astfel încât datele să poată circula între sisteme fără mapare personalizată.
- **Autorizare pe care pacientul o controlează**, nu doar credențiale pe care aplicația le controlează.
- **Proveniență**: cine a scris fiecare valoare, în numele cui, din ce sistem.
- **Istoric**: versiuni în loc de suprascrieri silențioase.
- **Auditabilitate** a citirilor, nu doar a scrierilor.
- **Reîncercări sigure** (idempotență) și **erori predictibile**, deoarece datele de sănătate nu trebuie duplicate sau pierdute.
- **Izolare** între aplicațiile care partajează aceeași infrastructură.
- **Reședința datelor** care corespunde locației pacienților.

Restul acestei pagini arată cum apare fiecare dintre acestea în API-ul Anpheros.

## Anpheros API pe scurt

| Suprafață | Cale de bază | Scop |
|---|---|---|
| FHIR R4 | `/fhir/R4` | 26 tipuri de resurse; read, search, create, update, delete, history, transactions, `$everything`, `$summary`, `$validate` |
| REST v1 | `/v1` | pacienți, observații, condiții, medicamente, documente, cronologie, proveniență, context AI, import laborator, terminologie, webhooks |
| OAuth 2.1 | `/oauth` | pagină de consimțământ, tokenuri (PKCE), revocare, chei OpenID Connect |
| Partea pacientului | `/me` | propriile înregistrări ale unei persoane, cine are acces, jurnal de acces, revocare |
| Descoperire | `/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json` | descrieri ale API-ului, citibile de mașini |

URL de bază: `https://platform.anpheros.com`. Sandbox-ul și producția îl partajează; cheia decide planul de date.

### Autentificare

- **Chei API** (`sk_test_…`, `sk_live_…`) pentru serverele dvs.; acestea văd pacienții creați de proiectul dvs.
- **Tokenuri de acces OAuth** (`at_…`) pentru o aplicație care acționează în numele unui pacient, sub un consimțământ.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

### Scriere în siguranță

Cereri `POST` acceptă un `Idempotency-Key`: o cerere reîncercată cu aceeași cheie returnează răspunsul original și nu creează nimic. Fiecare scriere primește un `Provenance`; tipul autorului este trimis în corpul cererii (`author_type`) sau în anteturi precum `X-Anpheros-Author-Type`, `X-Anpheros-Source-System`, `X-Anpheros-Origin-Id` și `X-Anpheros-On-Behalf-Of`.

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'
```

### Erori și limite

Endpoint-urile FHIR răspund cu `OperationOutcome`; celelalte cu `{"error": {"type", "message", "field"}}`. Fiecare răspuns conține `Anpheros-Request-Id`. Limita implicită este de 600 de cereri pe minut per cheie și per IP. [Erori](https://developers.anpheros.com/ro/guides/errors) · [Limite](https://developers.anpheros.com/ro/guides/limits)

### Evenimente

Webhooks semnate pentru `resource.created`, `resource.updated`, `resource.deleted`, `consent.granted`, `consent.revoked`, `document.finalized` și `ping`. [Webhooks](https://developers.anpheros.com/ro/guides/webhooks)

## Alegerea între FHIR și REST v1

Utilizați **FHIR** dacă lucrați deja cu FHIR, aveți nevoie de tipuri de resurse pe care `/v1` nu le acoperă (de exemplu `Immunization`, `Procedure` sau `CarePlan`) sau schimbați date cu alte sisteme FHIR. Utilizați **REST v1** pentru codul aplicației care dorește JSON plat pentru cazurile comune. Ambele citesc și scriu aceleași resurse cu aceleași ID-uri, deci un proiect le poate combina. [Medical data API](https://developers.anpheros.com/ro/guides/medical-data-api) descrie operațiunile pe date în detaliu.

## Întrebări frecvente

### Ce este un API de sănătate?
O interfață programatică prin care software-ul citește și scrie date de sănătate — fișe medicale ale pacienților, observații, diagnostice, medicamente și documente — și prin care este autorizat accesul la aceste date. API-urile moderne de sănătate utilizează HL7 FHIR R4 pentru date și OAuth 2.0 sau 2.1 cu SMART on FHIR pentru autorizare.

### Care este diferența dintre un API de sănătate și un API FHIR?
FHIR este un standard pe care îl poate urma un API de sănătate. Un API FHIR schimbă resurse FHIR prin REST; un API de sănătate poate accepta, de asemenea, mesaje HL7 v2, documente sau JSON proprietar. Anpheros oferă un API FHIR R4 și un API REST mai simplu peste aceleași date.

### Există un API de sănătate gratuit pentru dezvoltatori?
Da. Sandbox-ul Anpheros este gratuit și self-service: conectați-vă cu Google, obțineți o cheie API și lucrați cu 30 de pacienți sintetici prin FHIR R4 sau REST. Producția începe de la 99 € pe lună, cu prima lună gratuită.

### Cum își dau pacienții consimțământul pentru un API de sănătate?
Prin OAuth 2.1 cu PKCE: aplicația trimite persoana la o pagină de consimțământ cu scopuri SMART on FHIR; persoana alege ce să partajeze și pentru cât timp, poate vedea un jurnal de acces și poate revoca accesul în orice moment.

### Unde sunt stocate datele?
În Uniunea Europeană: serviciul și bazele sale de date rulează în Google Cloud `europe-west4` (Olanda).

### Ce API de sănătate ar trebui să aleg?
Comparați standardul de date, cine autorizează accesul, proveniența și auditul, rezidența datelor, cum se comportă reîncercările și erorile și dacă puteți testa cu date realiste gratuit. [Platformă API de sănătate: ce include și cum să alegi](https://developers.anpheros.com/ro/guides/healthcare-api-platform) transformă acestea în întrebări pe care să le adresați oricărui furnizor.

<!-- visual:cta-hapi -->

## Conexe

- [API EHR și API pentru dosare medicale](https://developers.anpheros.com/ro/guides/ehr-api)
- [Platformă API pentru sănătate: ce include și cum să alegi](https://developers.anpheros.com/ro/guides/healthcare-api-platform)
- [Cum să construiești un API pentru sănătate cu TypeScript](https://developers.anpheros.com/ro/guides/healthcare-api-typescript): tutorial pas cu pas cu Express
- [Cum să stochezi dosare medicale folosind FHIR R4](https://developers.anpheros.com/ro/guides/store-medical-records-fhir): tutorial pas cu pas cu curl
- [API pentru sănătate cu consimțământul pacientului](https://developers.anpheros.com/ro/guides/healthcare-api-patient-consent)
- [Backend SMART on FHIR](https://developers.anpheros.com/ro/guides/smart-on-fhir-backend)
- [API pentru date medicale](https://developers.anpheros.com/ro/guides/medical-data-api)
- [Platformă FHIR](https://developers.anpheros.com/ro/guides/fhir)
- [Interoperabilitatea datelor din domeniul sănătății](https://developers.anpheros.com/ro/guides/interoperability)
- [Integrări pentru sănătate](https://developers.anpheros.com/ro/guides/healthcare-integrations)
- [Referință API (OpenAPI)](https://developers.anpheros.com/docs) · [Autentificare și OAuth](https://developers.anpheros.com/ro/guides/authentication)