Egészségügyi adatok API-ja: mire figyelj, hogyan olvass és írj betegadatokat egy óra alatt

Az "egészségügyi API" sok mindent takar: egy kórház HL7 v2 feed-je, egy országos e-recept szolgáltatás, egy viselhető eszköz gyártójának exportja, egy FHIR szerver. Ha egészségügyi alkalmazást, klinikai eszközt vagy AI asszisztenst fejlesztesz, akkor ennél szűkebb körre van szükséged: egy olyan backendre, amely szabványos formátumban tárolja a páciens adatait, lehetővé teszi a páciens számára, hogy eldöntse, ki olvashassa azokat, és egy tiszta API-t biztosít ehhez. Ez az útmutató elmondja, mire kell figyelni, és valós hívásokkal bemutatja, hogyan telik az első óra az Anpheros Platformon.

Technikai verzió fejlesztőknek: Egészségügyi API · Orvosi adat API a developers.anpheros.com oldalon, kérésekkel, válaszokkal és korlátokkal. Ez az oldal a közérthető verzió.

Mit kell tudnia egy egészségügyi adat API-nak

Öt dolog különbözteti meg a használható egészségügyi adat API-t egy HTTP-vel ellátott adatbázistól.

• Szabványos formátum. A HL7 FHIR R4 az a formátum, amelyet a kórházak, nemzeti rendszerek és az EU egészségügyi adattere használ. A FHIR-ben tárolt rekordot más rendszerek is le tudják olvasni egyedi átjáró nélkül. Egy szabadalmaztatott JSON nem.
• Páciens hozzájárulás mint elsődleges objektum. Ki olvashatja, mit, mennyi ideig, visszavonható, látható a páciens számára. Nem egy pipálós doboz a saját adatbázisodban.
• Eredetiség (Provenance). Minden érték megmondja, ki írta: a páciens, egy orvos, egy eszköz, egy import, egy származtatott számítás. Egy AI asszisztens, amely nem tudja megkülönböztetni a laboreredményt egy önbevallott becsléstől, veszélyes.
• Homokozó (sandbox) valósághű adatokkal. Nem tesztelhetsz valódi páciensekkel, és nem kell magadnak 30 szintetikus pácienst kitalálnod hat hónapos előzménnyel.
• Adatlakóhely, amit meg tudsz nevezni. Az európai felhasználók számára ez azt jelenti, hogy szerverek az EU-ban, GDPR alatt, adatfeldolgozási megállapodással.

Két bemeneti út: REST és FHIR, ugyanaz az adat

Az Anpheros Platform ugyanazt a rekordot kétszer teszi elérhetővé. Egy egyszerű REST API (/v1) a termékkódhoz, és egy szigorú FHIR R4 (/fhir/R4) mindenhez, ami az egészségügyi rendszer többi részével kommunikálni kell. Az azonosítók mindkettőben azonosak; minden v1 objektum tartalmazza a fhir hivatkozását.

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

# a projekted által látható páciensek
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# laboreredmények, legújabbtól kezdve
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# aktív gyógyszerek
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# minden egy idővonalon
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# ugyanaz az adat, szigorú FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Ezek a hívások mögött 26 FHIR erőforrás típus áll (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance és még sok más), LOINC kódolással a mérésekhez, ICD-10 a kórképekhez és ATC a gyógyszerekhez.

Kulcs igénylése egy percet vesz igénybe

A homokozó önkiszolgáló és ingyenes. Jelentkezz be a dashboardra a platform.anpheros.com/dashboard címen, nyomd meg a Get a sandbox key gombot, és máris van egy szervezet, egy homokozó projekt és egy sk_test_… kulcsod. A projekt tartalmazza a 30 szintetikus páciens saját példányát: felnőttek, gyerekek és idősek Európa minden tájáról, hat hónapnyi kórképekkel, gyógyszerekkel, allergiákkal, laboreredményekkel és életjelekkel. Bármit módosíthatsz vagy törölhetsz; egy visszaállítás visszahozza őket.

A production kulcsok (sk_live_…) igazolt szervezeteknek járnak, aláírt adatfeldolgozási megállapodással. A homokozó és a production különböző adatbázisok: egy homokozó kulcs fizikailag nem érheti el a valós pácienseket.

Mi más van a dobozban

• OAuth 2.1 PKCE-vel és SMART on FHIR standalone launch, így egy alkalmazás hozzáférést kérhet egy személytől a saját rekordjához.
• Hozzájárulás hatókörökkel, lejárattal és visszavonással, valamint egy hozzáférési napló, amit a páciens elolvashat.
• Aláírt webhookok (HMAC-SHA256, visszavonással próbálkozva) resource.created, consent.granted, consent.revoked, document.finalized eseményekre.
• Egy AI kontext API, amely egy páciens eredetiség címkével ellátott összefoglalóját építi fel egy token kereten belül.
• Laborjelentés import CSV, HL7 v2 ORU^R01 vagy JSON formátumból, LOINC-ra leképezve.
• Nemzetközi Páciens Összefoglaló ($summary) és SMART Health Link QR kódos megosztáshoz.
• SDK-k Dart és TypeScript nyelven, egy OpenAPI referencia /docs címen és egy CapabilityStatement /fhir/R4/metadata címen.

A teljes bemutató, válaszokkal együtt, a developers.anpheros.com/guides/first-hour címen található.

Gyakori kérdések

Van ingyenes egészségügyi API, amivel ma elkezdhetek?

Igen. Az Anpheros homokozó ingyenes és önkiszolgáló: jelentkezz be, szerezz egy kulcsot, és máris van 30 szintetikus páciensed olvasásra és írásra. A korlátok naponta 10 000 erőforrás írás, 100 saját páciens és 250 MB dokumentum projektenként.

REST vagy FHIR, melyiket használjam?

Használd a /v1 -et a saját termékkódodhoz: egyszerűbb és sima JSON-t ad vissza. Használd a /fhir/R4 -et, amikor egy másik rendszernek kell olvasnia az adatokat, amikor FHIR keresésre, _history, $everything vagy $summary funkciókra van szükséged, vagy amikor egy tanúsítvány ezt kéri. Mindkettő ugyanazt a rekordot látja.

Hogyan kezelik a páciens hozzájárulását?

Egy személy OAuth-on keresztül ad hozzáférést egy alkalmazásnak a rekordjához, hatóköröket és időtartamot (30, 90, 180 vagy 365 nap) választva. A hozzájárulás bármikor visszavonható, és a páciens minden olvasást lát egy hozzáférési naplóban. Részletek a hozzájárulási modellben.

Hol tárolják az adatokat?

Az Európai Unióban (Cloud Run, europe-west4), minden íráshoz eredetiség és verziótörténet tartozik. A production használat aláírt adatfeldolgozási megállapodást igényel.

Mennyibe kerül a production?

A production havi 49 eurótól indul 2 500 tárolt páciens esetén, az első hónap ingyenes; nagyobb csomagok 199 és 799 euró havonta. A homokozó ingyenes marad. Lásd: árak.

Működik AI ügynökökkel?

Igen. Van egy AI kontext API eredetiség címkékkel és token kerettel, valamint egy MCP szerver a platform.anpheros.com/mcp címen, amelyhez bármely MCP-képes asszisztens csatlakozhat. Lásd: EMR integráció AI orvosi asszisztensekkel.