API pro zdravotnická data: co hledat a jak za hodinu číst a zapisovat záznam pacienta

"Zdravotnické API" zahrnuje velmi rozdílné věci: výstup nemocničního systému HL7 v2, národní službu elektronických receptů, export od výrobce nositelného zařízení, FHIR server. Pokud stavíte zdravotnickou aplikaci, klinický nástroj nebo asistenta s umělou inteligencí, potřebujete něco užšího: backend, který uchovává záznamy pacienta ve standardním formátu, umožňuje pacientovi rozhodovat, kdo si je může přečíst, a poskytuje vám čisté API. Tento průvodce říká, co hledat, a ukazuje na reálných voláních, jak vypadá první hodina na platformě Anpheros.

Technická verze pro vývojáře: Zdravotnické API · API pro lékařská data na developers.anpheros.com, s požadavky, odpověďmi a limity. Tato stránka je verze v běžném jazyce.

Co musí zdravotnické API pro data umět

Pět věcí odlišuje použitelné API pro zdravotnická data od databáze s HTTP před sebou.

• Standardní formát. HL7 FHIR R4 je formát, který používají nemocnice, národní systémy a evropský prostor pro zdravotnická data. Záznam uložený ve FHIR mohou číst jiné systémy bez vlastního propojení. Proprietární JSON to neumí.
• Souhlas pacienta jako primární objekt. Kdo smí co číst, jak dlouho, s možností odvolání, viditelné pro pacienta. Ne jen zaškrtávací políčko ve vaší vlastní databázi.
• Původ dat (Provenance). Každá hodnota říká, kdo ji zapsal: pacient, lékař, zařízení, import, odvozený výpočet. Asistent s umělou inteligencí, který nedokáže rozlišit laboratorní výsledek od domněnky nahlášené pacientem, je nebezpečný.
• Sandbox s realistickými daty. Nemůžete testovat s reálnými pacienty a nemusíte si sami vymýšlet 30 syntetických s šestiměsíční historií.
• Umístění dat, které můžete pojmenovat. Pro evropské uživatele to znamená servery v EU, pod GDPR, s dohodou o zpracování osobních údajů.

Dva způsoby přístupu: REST a FHIR, stejná data

Platforma Anpheros zpřístupňuje stejný záznam dvakrát. Jednoduché REST API (/v1) pro kód produktu a striktní FHIR R4 (/fhir/R4) pro vše, co musí komunikovat se zbytkem zdravotnického systému. ID jsou v obou případech stejná; každý objekt v1 nese svůj fhir odkaz.

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

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

# laboratorní výsledky, nejnovější první
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# aktivní léky
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# vše na jedné časové ose
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# stejná data, striktní FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Za těmito voláními stojí 26 typů zdrojů FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance a další), kódované pomocí LOINC pro měření, ICD-10 pro diagnózy a ATC pro léky.

Získání klíče trvá minutu

Sandbox je samoobslužný a zdarma. Přihlaste se do dashboardu na platform.anpheros.com/dashboard, klikněte na Získat sandbox klíč a získáte organizaci, sandbox projekt a klíč sk_test_…. Projekt obsahuje vlastní kopii 30 syntetických pacientů: dospělých, dětí a starších lidí z celé EU, s diagnózami, léky, alergiemi, laboratorními výsledky a vitálními funkcemi za šest měsíců. Cokoli změňte nebo smažte; reset je vrátí zpět.

Produkční klíče (sk_live_…) jsou určeny pro ověřené organizace s podepsanou dohodou o zpracování osobních údajů. Sandbox a produkce jsou různé databáze: sandbox klíč se fyzicky nedostane k reálnému pacientovi.

Co dalšího je v balení

• OAuth 2.1 s PKCE a SMART on FHIR standalone launch, takže aplikace může požádat osobu o přístup k jejímu vlastnímu záznamu.
• Souhlas s rozsahy (scopes), expirací a odvoláním a log přístupů, který si pacient může přečíst.
• Podepsané webhooks (HMAC-SHA256, opakované s prodlevou) pro resource.created, consent.granted, consent.revoked, document.finalized.
• API pro kontext AI, které sestaví souhrn pacienta s označením původu dat v rámci rozpočtu tokenů.
• Import laboratorních zpráv z CSV, HL7 v2 ORU^R01 nebo JSON, mapovaný na LOINC.
• International Patient Summary ($summary) a SMART Health Links pro sdílení pomocí QR kódu.
• SDK pro Dart a TypeScript, odkaz na OpenAPI na /docs a CapabilityStatement na /fhir/R4/metadata.

Kompletní návod s odpověďmi naleznete na developers.anpheros.com/guides/first-hour.

Časté otázky

Existuje bezplatné zdravotnické API, se kterým mohu začít dnes?

Ano. Sandbox Anpheros je zdarma a samoobslužný: přihlaste se, získejte klíč a máte 30 syntetických pacientů pro čtení a zápis. Limity jsou 10 000 zápisů zdrojů denně, 100 vlastních pacientů a 250 MB dokumentů na projekt.

REST nebo FHIR, co bych měl použít?

Použijte /v1 pro kód vašeho produktu: je jednodušší a vrací prostý JSON. Použijte /fhir/R4, když musí data číst jiný systém, když potřebujete vyhledávání FHIR, _history, $everything nebo $summary, nebo když to vyžaduje certifikace. Oba vidí stejný záznam.

Jak je řešen souhlas pacienta?

Osoba udělí aplikaci přístup ke svému záznamu prostřednictvím OAuth, přičemž si vybere rozsahy (scopes) a dobu trvání (30, 90, 180 nebo 365 dní). Udělení lze kdykoli odvolat a pacient vidí každý přístup v logu. Podrobnosti v modelu souhlasu.

Kde jsou data hostována?

V Evropské unii (Cloud Run, europe-west4), s původem dat a historií verzí u každého zápisu. Produkční použití vyžaduje podepsanou dohodu o zpracování osobních údajů.

Kolik stojí produkce?

Produkce začíná na 49 € měsíčně za 2 500 uložených pacientů, s prvním měsícem zdarma; větší plány stojí 199 € a 799 € měsíčně. Sandbox zůstává zdarma. Viz ceny.

Funguje to s agenty umělé inteligence?

Ano. Existuje API pro kontext AI s označením původu dat a rozpočtem tokenů, a MCP server na platform.anpheros.com/mcp, ke kterému se může připojit jakýkoli asistent s podporou MCP. Viz Integrace EMR s asistenty AI v medicíně.