AnpherosAnpheros PlatformDevelopers

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

Egészségügyi API: mi ez és hogyan működik

Mi az egészségügyi API, hogyan működik egy hívás, mire figyeljünk, és egy ingyenes FHIR R4 egészségügyi API páciens hozzájárulással, eredettel és EU-s tárhelyszolgáltatással – példákkal és GYIK-kel.

Az egészségügyi API egy programozási felület, amelyen keresztül a szoftverek egészségügyi adatokat – betegrekordokat, megfigyeléseket, diagnózisokat, gyógyszereket, dokumentumokat – olvasnak és írnak, és amelyen keresztül az adatokhoz való hozzáférést engedélyezik. Az Anpheros Platform API egy egészségügyi API egy beteg által vezérelt HL7 FHIR R4 rekord felett: az alkalmazások ezt használják orvosi adatok tárolására és lekérésére, a beteg beleegyezésének megszerzésére és a változásokról való értesítésre.

Hogyan működik egy egészségügyi API hívás

Bármelyik gyártóról is legyen szó, egy egészségügyi API hívás ugyanazokat az ellenőrzőpontokat futtatja végig: ki hív, melyik beteg és milyen adatokhoz férhet hozzá, hol tárolják az adatokat, ki írta azokat, és kinek kell tudnia a változásukról.

Egészségügyi API-k típusai

Típus Mit cserél Tipikus felhasználás
FHIR REST API-k FHIR erőforrások HTTP-n keresztül (GET /Observation?patient=…) a klinikai adatcsere modern szabványa
SMART on FHIR / OAuth engedélyezés FHIR API-khoz harmadik féltől származó alkalmazások számára, hogy a felhasználó engedélyével hozzáférjenek egy rekordhoz
HL7 v2 üzenetek pipe-delimitált üzenetek (ORU^R01 eredményekhez, ADT beutaztatásokhoz) laboratóriumi és kórházi rendszerek, gyakran interfészeken keresztül, nem pedig HTTP-n
Dokumentumcsere klinikai dokumentumok (PDF, CDA, FHIR dokumentumcsomagok) összefoglalók, elbocsátó levelek, beutalók
Szabadalmaztatott REST API-k gyártóspecifikus JSON egyetlen termék saját mobilalkalmazása vagy integrációi

Az Anpheros az első kettőt kombinálja magjaként, HL7 v2 laboratóriumi eredményeket fogad bemenetként, dokumentumokat az eredetiekkel együtt tárol, és FHIR dokumentumcsomagokat (International Patient Summary) állít elő. Egyszerűbb REST API-t is kínál ugyanazon adatok felett azoknak a fejlesztőknek, akik nem akarnak közvetlenül FHIR-rel dolgozni.

Mire figyeljünk egy egészségügyi API kiválasztásakor

What to look for in a healthcare API — and how Anpheros answers
Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM
Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation
ProvenanceAuthor, organisation and source on every write
HistoryEvery version kept; conditional updates with If-Match
Audit of readsEach read and write logged, visible to the patient
Safe retriesIdempotency-Key on POST; predictable errors
IsolationPairwise patient ids per application
Data residencyEuropean Union: Google Cloud europe-west4

Az oldal további része bemutatja, hogyan jelenik meg mindez az Anpheros API-ban.

Az Anpheros API áttekintése

Felület Alapútvonal Cél
FHIR R4 /fhir/R4 26 erőforrástípus; olvasás, keresés, létrehozás, frissítés, törlés, előzmények, tranzakciók, $everything, $summary, $validate
REST v1 /v1 betegek, megfigyelések, állapotok, gyógyszerek, dokumentumok, idővonal, származás, AI kontextus, laboratóriumi import, terminológia, webhookok
OAuth 2.1 /oauth hozzájárulási oldal, tokenek (PKCE), visszavonás, OpenID Connect kulcsok
Betegoldal /me egy személy saját rekordjai, ki rendelkezik hozzáféréssel, hozzáférési napló, visszavonás
Felfedezés /fhir/R4/metadata, /fhir/R4/.well-known/smart-configuration, /openapi.json az API géppel olvasható leírásai

Alap URL: https://platform.anpheros.com. A sandbox és a production ezt használja; a kulcs határozza meg az adatréteget.

Hitelesítés

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

Biztonságos írás

A POST kérések elfogadnak egy Idempotency-Key-t: egy újraküldött kérés ugyanazzal a kulccsal visszaadja az eredeti választ, és nem hoz létre semmit. Minden írás kap egy Provenance-t; az író típusa a törzsben (author_type) vagy olyan fejlécben kerül elküldésre, mint a X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id és 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"}'

Hibák és korlátok

A FHIR végpontok OperationOutcome-val válaszolnak; a többi {"error": {"type", "message", "field"}}-vel. Minden válasz tartalmaz Anpheros-Request-Id-t. Az alapértelmezett korlát percenként 600 kérés kulcsonként és IP címenként. Hibák · Korlátok

Események

Aláírt webhookok a resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized és ping eseményekhez. Webhookok

FHIR és REST v1 közötti választás

Használja a FHIR-t, ha már dolgozik FHIR-rel, olyan erőforrástípusokra van szüksége, amelyeket a /v1 nem fed le (például Immunization, Procedure vagy CarePlan), vagy más FHIR rendszerekkel cserél adatot. Használja a REST v1-et olyan alkalmazáskódokhoz, amelyek a gyakori esetekben lapos JSON-t szeretnének. Mindkettő ugyanazokat az erőforrásokat olvassa és írja ugyanazokkal az azonosítókkal, így egy projekt keverheti őket. A Medical data API részletesen ismerteti az adatműveleteket.

Gyakran ismételt kérdések

Mi az egészségügyi API?

Programozható interfész, amelyen keresztül a szoftver egészségügyi adatokat – betegrekordokat, megfigyeléseket, diagnózisokat, gyógyszereket és dokumentumokat – olvas és ír, és amelyen keresztül az adatokhoz való hozzáférés engedélyezett. A modern egészségügyi API-k HL7 FHIR R4-et használnak az adatokhoz, és OAuth 2.0 vagy 2.1 SMART on FHIR-rel a hozzáférés engedélyezéséhez.

Mi a különbség az egészségügyi API és a FHIR API között?

A FHIR egy olyan szabvány, amelyet egy egészségügyi API követhet. A FHIR API FHIR erőforrásokat cserél REST-en keresztül; egy egészségügyi API elfogadhat HL7 v2 üzeneteket, dokumentumokat vagy saját JSON formátumot is. Az Anpheros kínál egy FHIR R4 API-t és egy egyszerűbb REST API-t ugyanazon adatok felett.

Van ingyenes egészségügyi API fejlesztőknek?

Igen. Az Anpheros sandbox ingyenes és önkiszolgáló: jelentkezzen be Google-lel, szerezzen API kulcsot, és dolgozzon 30 szintetikus beteggel FHIR R4 vagy REST protokollon keresztül. A termelés havi 49 eurótól indul, az első hónap ingyenes.

Hogyan adnak a betegek hozzájárulást egy egészségügyi API-hoz?

OAuth 2.1 PKCE-vel: az alkalmazás elküldi a személyt egy hozzájárulási oldalra SMART on FHIR hatókörökkel; a személy kiválasztja, mit oszt meg és mennyi ideig, megtekintheti a hozzáférési naplót, és bármikor visszavonhatja a hozzáférést.

Hol tárolják az adatokat?

Az Európai Unióban: a szolgáltatás és annak adatbázisai a Google Cloud europe-west4 (Hollandia) rendszerében futnak.

Melyik egészségügyi API-t válasszam?

Hasonlítsa össze az adat szabványt, ki engedélyezi a hozzáférést, a származást és az auditálást, az adatok tartózkodási helyét, hogyan viselkednek az ismétlési kísérletek és a hibák, valamint hogy ingyenesen tesztelhet-e valósághű adatokkal. A Egészségügyi API platform: mit tartalmaz és hogyan válasszunk ezeket kérdésekké alakítja, amelyeket bármely eladónak feltehet.

Kapcsolódó

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

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy