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

Zdravotnické API: co to je a jak funguje

Co je zdravotnické API, jak funguje jeden požadavek, na co se zaměřit a bezplatné FHIR R4 zdravotnické API se souhlasem pacienta, původem dat a hostingem v EU — s příklady a FAQ.

Healthcare API je programové rozhraní, jehož prostřednictvím software čte a zapisuje zdravotnická data — záznamy pacientů, pozorování, diagnózy, léky, dokumenty — a jehož prostřednictvím je autorizován přístup k těmto datům. Anpheros Platform API je healthcare API nad záznamem HL7 FHIR R4 ovládaným pacientem: aplikace jej používají k ukládání a načítání lékařských dat, k získání souhlasu pacienta a k upozornění na změny.

Jak funguje volání zdravotnického API

Bez ohledu na dodavatele projde volání zdravotnického API stejnými kontrolními body: kdo volá, kterého pacienta a jaká data může ovlivnit, kde jsou data uložena, kdo je napsal a kdo potřebuje vědět, že se změnila.

Druhy zdravotnických API

Anpheros kombinuje první dvě jako své jádro, přijímá laboratorní výsledky HL7 v2 jako vstup, ukládá dokumenty s jejich originály a produkuje FHIR document bundles (International Patient Summary). Nabízí také jednodušší REST API nad stejnými daty pro vývojáře, kteří nechtějí pracovat přímo s FHIR.

Co hledat v API pro zdravotnictví

Zbytek této stránky ukazuje, jak se každý z těchto bodů projevuje v Anpheros API.

Anpheros API v kostce

Základní URL: https://platform.anpheros.com. Sandbox a produkční prostředí sdílejí stejnou URL; klíč určuje datovou rovinu.

Autentizace

• API klíče (sk_test_…, sk_live_…) pro vaše servery; vidí pacienty, které váš projekt vytvořil.
• OAuth přístupové tokeny (at_…) pro aplikaci jednající jménem jednoho pacienta na základě souhlasu.

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

Bezpečné zápisy

Požadavky na zápis (write) přijímají POST: opakovaný požadavek se stejným klíčem vrátí původní odpověď a nic nevytvoří. Každý zápis obdrží Idempotency-Key; typ autora je odeslán v těle požadavku (Provenance) nebo v hlavičkách jako author_type, X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id a 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"}'

Chyby a limity

FHIR koncové body odpovídají pomocí OperationOutcome; ostatní pomocí {"error": {"type", "message", "field"}}. Každá odpověď obsahuje Anpheros-Request-Id. Výchozí limit je 600 požadavků za minutu na klíč a na IP. Chyby · Limity

Události

Podepsané webhooks pro resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized a ping. Webhooks

Volba mezi FHIR a REST v1

Použijte FHIR, pokud již pracujete s FHIR, potřebujete typy zdrojů, které /v1 nepokrývá (například Immunization, Procedure nebo CarePlan), nebo si vyměňujete data s jinými systémy FHIR. Použijte REST v1 pro aplikační kód, který chce pro běžné případy ploché JSON. Oba čtou a zapisují stejné zdroje se stejnými ID, takže je projekt může kombinovat. Medical data API podrobně popisuje datové operace.

Často kladené dotazy

Co je to zdravotnické API?

Programové rozhraní, jehož prostřednictvím software čte a zapisuje zdravotnická data — záznamy pacientů, pozorování, diagnózy, léky a dokumenty — a jehož prostřednictvím je autorizován přístup k těmto datům. Moderní zdravotnická API používají HL7 FHIR R4 pro data a OAuth 2.0 nebo 2.1 se SMART on FHIR pro autorizaci.

Jaký je rozdíl mezi zdravotnickým API a FHIR API?

FHIR je jeden ze standardů, kterými se zdravotnické API může řídit. FHIR API vyměňuje FHIR zdroje přes REST; zdravotnické API může také přijímat zprávy HL7 v2, dokumenty nebo proprietární JSON. Anpheros nabízí FHIR R4 API a jednodušší REST API nad stejnými daty.

Existuje bezplatné zdravotnické API pro vývojáře?

Ano. Sandbox Anpheros je zdarma a samoobslužný: přihlaste se pomocí Google, získejte API klíč a pracujte se 30 syntetickými pacienty přes FHIR R4 nebo REST. Produkční prostředí začíná na 99 € měsíčně, první měsíc zdarma.

Jak pacienti udělují souhlas zdravotnickému API?

Prostřednictvím OAuth 2.1 s PKCE: aplikace odešle osobu na stránku se souhlasem se SMART on FHIR scopes; osoba si vybere, co sdílet a na jak dlouho, může vidět log přístupů a může kdykoli odvolat přístup.

Kde jsou data uložena?

V Evropské unii: služba a její databáze běží v Google Cloud europe-west4 (Nizozemsko).

Které zdravotnické API bych měl zvolit?

Porovnejte datový standard, kdo autorizuje přístup, původ a audit, umístění dat, jak se chovají opakované pokusy a chyby a zda můžete zdarma testovat s realistickými daty. Platforma zdravotnického API: co obsahuje a jak si vybrat převádí tyto otázky do otázek, které můžete položit jakémukoli dodavateli.

Související

• EHR API a API pro lékařské záznamy
• Platforma pro API ve zdravotnictví: co zahrnuje a jak si vybrat
• Jak vytvořit API pro zdravotnictví pomocí TypeScript: podrobný návod s Express
• Jak ukládat lékařské záznamy pomocí FHIR R4: podrobný návod s curl
• API pro zdravotnictví s pacientovým souhlasem
• Backend SMART on FHIR
• API pro lékařská data
• Platforma FHIR
• Interoperabilita dat ve zdravotnictví
• Integrace ve zdravotnictví
• Referenční příručka API (OpenAPI) · Autentizace a OAuth

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