# Integrări în domeniul sănătății

> Modele de integrare suportate astăzi: rapoarte de laborator într-un singur apel, clinici care scriu în numele unei organizații, dispozitive, aplicații terțe consimțite, webhooks și SDK-uri — și ce nu este disponibil.

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

**O integrare în domeniul sănătății conectează un sistem care produce sau necesită date medicale — un laborator, o clinică, un dispozitiv, o altă aplicație — la dosarul pacientului.** Cu Anpheros, fiecare integrare trece prin același API și aceleași reguli: datele sunt scrise ca HL7 FHIR R4, atribuite sursei lor, vizibile pacientului și partajate cu alte părți doar sub consimțământul pacientului. Această pagină descrie modelele de integrare pe care platforma le suportă astăzi.

[Explorați directorul de integrări Anpheros](https://anpheros.com/integrations) pentru a vedea fiecare integrare cu statutul său verificat (disponibil, beta sau ghid pentru dezvoltatori), datele și resursele FHIR pe care le schimbă, direcția sa, autentificarea și documentația.

## Laboratoare: rapoarte complete într-un singur apel

Un laborator, sau orice sistem care deține rapoarte de laborator, trimite un raport complet, iar platforma transformă fiecare rezultat într-un laborator `Observation`:

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- Formate: **CSV** (anteturi în română sau engleză, virgulă zecimală acceptată), **HL7 v2 ORU^R01** și **JSON**.
- Markerii sunt mapați la **LOINC** atunci când raportul oferă un cod sau numele se potrivește cu terminologia platformei; alții păstrează codul propriu al laboratorului și sunt listați ca `unmapped`.
- Fiecare rând primește un identificator stabil, astfel **re-trimiterea aceluiași raport omite ceea ce a fost deja importat**.
- Până la 500 de rânduri per cerere; fiecare rezultat poartă proveniența, numind sistemul sursă și raportul.

Detalii: [Conector laborator](https://developers.anpheros.com/ro/guides/lab-connector).

## Clinici: scrierea în numele unei organizații

Clinicile și persoanele care lucrează acolo sunt resurse de director (`Organization`, `Practitioner`, `PractitionerRole`). Sistemul unei clinici poate apoi indica cine se află în spatele fiecărei solicitări:

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — practicianul care lucrează prin intermediul aplicației dvs.; scris în log-ul de acces și afișat pacientului după nume;
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — organizația pentru care se face o scriere;
- `X-Anpheros-Author-Ref: Practitioner/<id>` — autorul înregistrat în `Provenance`.

Cu consimțământul pacientului, clinica citește întregul dosar, inclusiv ce au scris alte organizații, și modifică doar ceea ce a scris ea însăși. Mai multe resurse pot fi scrise atomic cu un pachet FHIR `transaction` (`POST /fhir/R4`).

Un exemplu practic, de la director la o vizită scrisă ca o singură tranzacție: [Cum să integrați sistemele clinice cu un backend FHIR](https://developers.anpheros.com/ro/guides/integrate-clinic-systems-fhir).

Fluxul consimțământ → laborator `Observation` scris de un proiect de clinică → notificare în aplicația pacientului a fost exercitat end-to-end cu un proiect de clinică de test.

## Dispozitive și dispozitive purtabile

Măsurătorile de la dispozitive sunt `Observation`s cu `author_type: "device"` și un cod LOINC — ritm cardiac, tensiune arterială, SpO₂, greutate, glucoză, pași, durata somnului și altele ([Sisteme de coduri FHIR](https://developers.anpheros.com/ro/guides/fhir-code-systems)). Anpheros Daily scrie rezumatele zilnice pe care le citește din Apple Health și Health Connect ca Observații în același mod. Anpheros nu se conectează direct la cloud-urile furnizorilor de dispozitive; aplicația sau backend-ul dvs. citește dispozitivul și scrie rezultatul. Cum să citiți Apple Health, Health Connect și Samsung Health și să mapați fiecare metrică la LOINC: [Date de la dispozitive purtabile în FHIR](https://developers.anpheros.com/ro/guides/wearable-data-fhir).

## Aplicații terțe: acces consimțit

O aplicație care dorește date pe care o persoană le deține deja în Anpheros se înregistrează o dată și solicită consimțământul prin OAuth 2.1 cu PKCE (lansare independentă SMART on FHIR):

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — pagina de consimțământ găzduită;
2. persoana alege înregistrarea și durata (30, 90, 180 sau 365 de zile);
3. `POST /oauth/token` schimbă codul pentru un token de acces (30 de minute) și un token de reîmprospătare rotativ (30 de zile);
4. aplicația vede doar acel pacient, doar în cadrul domeniilor sale (scopes), sub propriul său ID pereche.

[Autentificare și OAuth](https://developers.anpheros.com/ro/guides/authentication)

## Evenimente: reacționând la modificări

În loc să interogați, înregistrați un webhook. Livrările sunt semnate cu HMAC-SHA256, reîncercate cu backoff timp de până la 24 de ore și transportă ID-uri, niciodată conținut clinic. Când un alt proiect scrie într-o înregistrare la care aveți acces, evenimentul indică acest lucru (`data.external: true`, cu sursa). [Webhooks](https://developers.anpheros.com/ro/guides/webhooks)

## SDK-uri

SDK-urile TypeScript (`@anpheros/sdk`) și Dart / Flutter (`anpheros_sdk`) implementează tot ce este menționat mai sus — import de laborator (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth cu PKCE, gestionarea webhook-urilor și verificarea semnăturii. [SDK-uri](https://developers.anpheros.com/ro/guides/sdks)

## Ce nu este disponibil

- Conectori pre-fabricați către sisteme EHR sau sisteme informatice de laborator specifice; integrările sunt construite împotriva API-ului.
- Lansare SMART EHR (lansare în interiorul unui EHR); este suportată doar lansarea independentă.
- Integrări directe cu furnizorii de dispozitive.

## Conexe

- [Cum să integrați sistemele clinice cu un backend FHIR](https://developers.anpheros.com/ro/guides/integrate-clinic-systems-fhir): tutorial pas cu pas pentru EMR-uri clinice
- [Cum să normalizați datele medicale](https://developers.anpheros.com/ro/guides/normalize-medical-data): coduri, unități, date, duplicate, validare
- [Cum să importați rezultatele de laborator într-o înregistrare FHIR](https://developers.anpheros.com/ro/guides/import-lab-results-fhir): tutorial pas cu pas cu CSV și HL7 v2
- [Interoperabilitatea datelor din domeniul sănătății](https://developers.anpheros.com/ro/guides/interoperability)
- [API pentru Sănătate](https://developers.anpheros.com/ro/guides/healthcare-api)
- [Arhitectură](https://developers.anpheros.com/ro/guides/architecture)
- [Cazuri de utilizare](https://developers.anpheros.com/ro/guides/use-cases)
