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

API de sănătate: ce este și cum funcționează

Ce este un API de sănătate, cum funcționează un apel, la ce să vă așteptați și un API de sănătate FHIR R4 gratuit cu consimțământul pacientului, proveniență și găzduire în UE — cu exemple și FAQ.

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.

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.

Tipuri de API-uri pentru sănătate

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

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

Anpheros API pe scurt

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.

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.

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 · Limite

Evenimente

Webhooks semnate pentru resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized și ping. 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 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 transformă acestea în întrebări pe care să le adresați oricărui furnizor.

Conexe

• API EHR și API pentru dosare medicale
• Platformă API pentru sănătate: ce include și cum să alegi
• Cum să construiești un API pentru sănătate cu TypeScript: tutorial pas cu pas cu Express
• Cum să stochezi dosare medicale folosind FHIR R4: tutorial pas cu pas cu curl
• API pentru sănătate cu consimțământul pacientului
• Backend SMART on FHIR
• API pentru date medicale
• Platformă FHIR
• Interoperabilitatea datelor din domeniul sănătății
• Integrări pentru sănătate
• Referință API (OpenAPI) · Autentificare și OAuth

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