API pre zdravotnícke údaje: čo hľadať a ako za hodinu čítať a zapisovať záznam pacienta

"API pre zdravotníctvo" zahŕňa veľmi rozdielne veci: HL7 v2 feed nemocnice, národná služba elektronických receptov, export od predajcu nositeľných zariadení, FHIR server. Ak vyvíjate zdravotnícku aplikáciu, klinický nástroj alebo AI asistenta, potrebujete niečo užšie: backend, ktorý uchováva záznam pacienta v štandardnom formáte, umožňuje pacientovi rozhodnúť, kto si ho môže prečítať, a poskytuje vám čisté API. Tento sprievodca hovorí, čo hľadať, a ukazuje s reálnymi volaniami, ako vyzerá prvá hodina na platforme Anpheros.

Technická verzia pre vývojárov: API pre zdravotníctvo · API pre lekárske údaje na developers.anpheros.com, s požiadavkami, odpoveďami a limitmi. Táto stránka je verzia v bežnom jazyku.

Čo musí spĺňať API pre zdravotnícke údaje

Päť vecí oddeľuje použiteľné API pre zdravotnícke údaje od databázy s HTTP pred ňou.

• Štandardný formát. HL7 FHIR R4 je formát, ktorý používajú nemocnice, národné systémy a európsky priestor pre zdravotnícke údaje. Záznam uložený vo FHIR môžu čítať iné systémy bez vlastného prepojenia. Vlastný JSON to nedokáže.
• Súhlas pacienta ako prvotriedny objekt. Kto môže čo čítať, ako dlho, s možnosťou odvolania, viditeľné pre pacienta. Nie ako začiarkavacie políčko vo vašej vlastnej databáze.
• Pôvod. Každá hodnota hovorí, kto ju zapísal: pacient, lekár, zariadenie, import, odvodený výpočet. AI asistent, ktorý nedokáže rozlíšiť laboratórny výsledok od vlastného odhadu, je nebezpečný.
• Sandbox s realistickými údajmi. Nemôžete testovať so skutočnými pacientmi a nemusíte si sami vymýšľať 30 syntetických pacientov s polročnou históriou.
• Umiestnenie údajov, ktoré môžete pomenovať. Pre európskych používateľov to znamená servery v EÚ, pod GDPR, so zmluvou o spracovaní údajov.

Dva spôsoby prístupu: REST a FHIR, rovnaké údaje

Platforma Anpheros sprístupňuje rovnaký záznam dvakrát. Jednoduché REST API (/v1) pre kód produktu a prísne FHIR R4 (/fhir/R4) pre čokoľvek, čo musí komunikovať so zvyškom zdravotníckeho systému. ID sú v oboch rovnaké; každý objekt v1 nesie svoj fhir odkaz.

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

# pacienti, ktorých váš projekt vidí
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# laboratórne výsledky, najnovšie prvé
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

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

# všetko na jednej časovej osi
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# rovnaké údaje, prísne FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Za týmito volaniami sa skrývajú 26 typov FHIR zdrojov (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance a ďalšie), kódované s LOINC pre merania, ICD-10 pre diagnózy a ATC pre lieky.

Získanie kľúča trvá minútu

Sandbox je samoobslužný a bezplatný. Prihláste sa do dashboardu na platform.anpheros.com/dashboard, stlačte Získať sandbox kľúč a získate organizáciu, sandbox projekt a kľúč sk_test_…. Projekt prichádza s vlastnou kópiou 30 syntetických pacientov: dospelí, deti a starší ľudia z celej EÚ, s diagnózami, liekmi, alergiami, laboratórnymi výsledkami a vitálnymi funkciami za šesť mesiacov. Čokoľvek zmeňte alebo zmažte; reset ich vráti späť.

Produkčné kľúče (sk_live_…) sú určené pre overené organizácie s podpísanou zmluvou o spracovaní údajov. Sandbox a produkcia sú rôzne databázy: sandbox kľúč sa fyzicky nedostane k skutočnému pacientovi.

Čo ešte je v balení

• OAuth 2.1 s PKCE a SMART on FHIR samostatné spustenie, takže aplikácia môže požiadať osobu o prístup k jej vlastnému záznamu.
• Súhlas s rozsahmi (scopes), platnosťou a odvolaním, a denník prístupu, ktorý si pacient môže prečítať.
• Podpísané webové háčiky (HMAC-SHA256, opakované pokusy s postupným oneskorením) pre resource.created, consent.granted, consent.revoked, document.finalized.
• AI kontextové API, ktoré zostavuje súhrn pacienta s označením pôvodu v rámci rozpočtu tokenov.
• Import laboratórnych správ z CSV, HL7 v2 ORU^R01 alebo JSON, namapovaný na LOINC.
• International Patient Summary ($summary) a SMART Health Links na zdieľanie pomocou QR kódu.
• SDK pre Dart a TypeScript, OpenAPI referenciu na /docs a CapabilityStatement na /fhir/R4/metadata.

Kompletný prehľad s odpoveďami nájdete na developers.anpheros.com/guides/first-hour.

Časté otázky

Existuje bezplatné API pre zdravotníctvo, s ktorým môžem začať dnes?

Áno. Sandbox Anpheros je bezplatný a samoobslužný: prihláste sa, získajte kľúč a máte 30 syntetických pacientov na čítanie a zápis. Limity sú 10 000 zápisov zdrojov denne, 100 vlastných pacientov a 250 MB dokumentov na projekt.

REST alebo FHIR, ktoré by som mal použiť?

Použite /v1 pre váš vlastný kód produktu: je jednoduchší a vracia bežný JSON. Použite /fhir/R4, keď iný systém musí čítať údaje, keď potrebujete FHIR vyhľadávanie, _history, $everything alebo $summary, alebo keď to vyžaduje certifikácia. Oba vidia rovnaký záznam.

Ako sa spracúva súhlas pacienta?

Osoba udelí aplikácii prístup k svojmu záznamu prostredníctvom OAuth, pričom vyberie rozsahy (scopes) a dobu trvania (30, 90, 180 alebo 365 dní). Udelenie môže byť kedykoľvek odvolané a pacient vidí každý prístup v denníku prístupu. Podrobnosti v modeli súhlasu.

Kde sú údaje hostované?

V Európskej únii (Cloud Run, europe-west4), s pôvodom a históriou verzií pri každom zápise. Produkčné použitie vyžaduje podpísanú zmluvu o spracovaní údajov.

Koľko stojí produkcia?

Produkcia začína na 49 € mesačne za 2 500 uložených pacientov, s prvým mesiacom zdarma; väčšie plány sú 199 € a 799 € mesačne. Sandbox zostáva bezplatný. Pozrite si ceny.

Funguje to s AI agentmi?

Áno. Existuje AI kontextové API s označeniami pôvodu a rozpočtom tokenov, a MCP server na platform.anpheros.com/mcp, ku ktorému sa môže pripojiť akýkoľvek MCP-kompatibilný asistent. Pozrite si integráciu EMR s AI lekárskymi asistentmi.