API pentru date medicale: ce să cauți, cum să citești și să scrii un dosar medical în o oră

„API pentru Sănătate” acoperă lucruri foarte diferite: un flux HL7 v2 al unui spital, un serviciu național de prescripții electronice, exportul unui furnizor de dispozitive purtabile, un server FHIR. Dacă construiți o aplicație de sănătate, un instrument clinic sau un asistent AI, ceea ce aveți nevoie este mai restrâns: un backend care deține dosarul unui pacient într-un format standard, permite pacientului să decidă cine îl citește și vă oferă un API curat peste acesta. Acest ghid spune ce să căutați și arată, cu apeluri reale, cum arată prima oră pe Platforma Anpheros.

Versiune tehnică pentru dezvoltatori: API pentru Sănătate · API pentru date medicale pe developers.anpheros.com, cu cereri, răspunsuri și limite. Această pagină este versiunea în limbaj simplu.

Ce trebuie să facă un API pentru date medicale

Cinci lucruri separă un API utilizabil pentru date medicale de o bază de date cu HTTP în față.

• Un format standard. HL7 FHIR R4 este formatul pe care îl folosesc spitalele, sistemele naționale și spațiul european de date medicale. Un dosar stocat în FHIR poate fi citit de alte sisteme fără o punte personalizată. Un JSON proprietar nu poate.
• Consimțământul pacientului ca obiect de prim rang. Cine poate citi ce, pentru cât timp, revocabil, vizibil pentru pacient. Nu o căsuță de bifat în propria bază de date.
• Proveniența. Fiecare valoare spune cine a scris-o: pacientul, un practician, un dispozitiv, o importare, un calcul derivat. Un asistent AI care nu poate distinge un rezultat de laborator de o presupunere auto-raportată este periculos.
• Un sandbox cu date realiste. Nu puteți testa cu pacienți reali și nu ar trebui să fie nevoie să inventați singuri 30 de pacienți sintetici cu șase luni de istoric.
• Locația datelor pe care o puteți numi. Pentru utilizatorii europeni, aceasta înseamnă servere în UE, sub GDPR, cu un acord de procesare a datelor.

Două moduri de acces: REST și FHIR, aceleași date

Platforma Anpheros expune același dosar de două ori. Un API REST simplu (/v1) pentru codul produsului și FHIR R4 strict (/fhir/R4) pentru orice trebuie să comunice cu restul sistemului de sănătate. ID-urile sunt identice în ambele; fiecare obiect v1 poartă referința sa fhir.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# pacienții pe care proiectul dvs. îi poate vedea
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# rezultate de laborator, cele mai noi primele
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# medicamente active
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# totul pe o singură cronologie
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# aceleași date, FHIR strict
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

În spatele acestor apeluri se află 26 de tipuri de resurse FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance și altele), codificate cu LOINC pentru măsurători, ICD-10 pentru afecțiuni și ATC pentru medicamente.

Obținerea unei chei durează un minut

Sandbox-ul este self-service și gratuit. Conectați-vă la dashboard la platform.anpheros.com/dashboard, apăsați Obțineți o cheie sandbox și veți avea o organizație, un proiect sandbox și o cheie sk_test_…. Proiectul vine cu propria copie a 30 de pacienți sintetici: adulți, copii și persoane în vârstă din întreaga UE, cu afecțiuni, medicamente, alergii, rezultate de laborator și semne vitale pe parcursul a șase luni. Modificați sau ștergeți orice; o resetare îi readuce.

Cheile de producție (sk_live_…) sunt destinate organizațiilor verificate cu un acord de procesare a datelor semnat. Sandbox-ul și producția sunt baze de date diferite: o cheie sandbox nu poate ajunge fizic la un pacient real.

Ce altceva este în pachet

• OAuth 2.1 cu PKCE și SMART pe FHIR standalone launch, astfel încât o aplicație să poată solicita unei persoane acces la propriul dosar.
• Consimțământ cu scopuri, expirare și revocare și un jurnal de acces pe care pacientul îl poate citi.
• Webhooks semnate (HMAC-SHA256, reîncercate cu backoff) pentru resource.created, consent.granted, consent.revoked, document.finalized.
• Un API de context AI care construiește un rezumat al unui pacient etichetat cu proveniență, în limita unui buget de token-uri.
• Import de rapoarte de laborator din CSV, HL7 v2 ORU^R01 sau JSON, mapate la LOINC.
• Rezumat Internațional al Pacientului ($summary) și SMART Health Links pentru partajare prin QR.
• SDK-uri pentru Dart și TypeScript, o referință OpenAPI la /docs și o Declarație de Capacitate la /fhir/R4/metadata.

Parcurgerea completă, cu răspunsuri, este disponibilă la developers.anpheros.com/guides/first-hour.

Întrebări frecvente

Există un API gratuit pentru sănătate cu care pot începe astăzi?

Da. Sandbox-ul Anpheros este gratuit și self-service: conectați-vă, obțineți o cheie și aveți 30 de pacienți sintetici pentru a citi și scrie. Limitele sunt 10.000 de scrieri de resurse pe zi, 100 de pacienți proprii și 250 MB de documente per proiect.

REST sau FHIR, pe care ar trebui să-l folosesc?

Folosiți /v1 pentru codul propriu al produsului: este mai simplu și returnează JSON simplu. Folosiți /fhir/R4 atunci când un alt sistem trebuie să citească datele, când aveți nevoie de căutare FHIR, _history, $everything sau $summary, sau când o certificare o cere. Ambele văd același dosar.

Cum este gestionat consimțământul pacientului?

O persoană acordă unei aplicații acces la dosarul său prin OAuth, alegând scopuri și o durată (30, 90, 180 sau 365 de zile). Acordul poate fi revocat în orice moment, iar pacientul vede fiecare citire într-un jurnal de acces. Detalii în modelul de consimțământ.

Unde sunt găzduite datele?

În Uniunea Europeană (Cloud Run, europe-west4), cu proveniență și istoric de versiuni la fiecare scriere. Utilizarea în producție necesită un acord de procesare a datelor semnat.

Cât costă producția?

Producția începe de la 49 € pe lună pentru 2.500 de pacienți stocați, cu prima lună gratuită; planurile mai mari sunt de 199 € și 799 € pe lună. Sandbox-ul rămâne gratuit. Consultați prețurile.

Funcționează cu agenți AI?

Da. Există un API de context AI cu etichete de proveniență și un buget de token-uri, și un server MCP la platform.anpheros.com/mcp la care se poate conecta orice asistent capabil de MCP. Consultați Integrarea EMR cu asistenți medicali AI.