# Zdravotnícke integrácie > Dnes podporované integračné vzory: laboratórne správy v jednom volaní, kliniky zapisujúce v mene organizácie, zariadenia, súhlasené aplikácie tretích strán, webové háčiky a SDK – a to, čo nie je k dispozícii. Source: https://developers.anpheros.com/sk/guides/healthcare-integrations **Zdravotnícka integrácia spája systém, ktorý produkuje alebo potrebuje zdravotné údaje – laboratórium, kliniku, zariadenie, inú aplikáciu – s pacientovým záznamom.** S Anpheros prechádza každá integrácia cez rovnaké API a rovnaké pravidlá: údaje sa zapisujú ako HL7 FHIR R4, pripisujú sa ich zdroju, sú viditeľné pre pacienta a zdieľajú sa s inými stranami iba s pacientovým súhlasom. Táto stránka popisuje integračné vzory, ktoré platforma dnes podporuje. [Preskúmajte adresár integrácií Anpheros](https://anpheros.com/integrations), aby ste videli každú integráciu s jej overeným stavom (dostupná, beta alebo sprievodca pre vývojárov), údaje a zdroje FHIR, ktoré si vymieňa, jej smer, autentizáciu a dokumentáciu. ## Laboratóriá: celé správy v jednom volaní Laboratórium, alebo akýkoľvek systém, ktorý uchováva laboratórne správy, pošle kompletnú správu a platforma premení každý výsledok na laboratórny `Observation`: ```bash curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \ -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \ -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \ --data-binary @report.csv ``` - Formáty: **CSV** (hlavičky v rumunčine alebo angličtine, desatinná čiarka akceptovaná), **HL7 v2 ORU^R01** a **JSON**. - Markery sú mapované na **LOINC**, keď správa poskytuje kód alebo názov zodpovedá terminológii platformy; ostatné si zachovávajú vlastný kód laboratória a sú uvedené ako `unmapped`. - Každý riadok dostane stabilný identifikátor, takže **opätovné odoslanie tej istej správy preskočí to, čo už bolo importované**. - Až 500 riadkov na požiadavku; každý výsledok nesie pôvod pomenúvajúci zdrojový systém a správu. Detaily: [Lab connector](https://developers.anpheros.com/sk/guides/lab-connector). ## Kliniky: zápis v mene organizácie Kliniky a ľudia, ktorí tam pracujú, sú adresárové zdroje (`Organization`, `Practitioner`, `PractitionerRole`). Systém kliniky potom môže určiť, kto stojí za každou požiadavkou: - `X-Anpheros-Acting-As: PractitionerRole/` — praktikujúci, ktorý pracuje prostredníctvom vašej aplikácie; zapísané do prístupového denníka a zobrazené pacientovi podľa mena; - `X-Anpheros-On-Behalf-Of: Organization/` — organizácia, pre ktorú je zápis vykonaný; - `X-Anpheros-Author-Ref: Practitioner/` — autor zaznamenaný v `Provenance`. So súhlasom pacienta si klinika prečíta celý záznam, vrátane toho, čo napísali iné organizácie, a zmení iba to, čo napísala sama. Viacero zdrojov je možné zapísať atomicky pomocou FHIR `transaction` bundle (`POST /fhir/R4`). Pracovný príklad, od adresára po návštevu zapísanú ako jedna transakcia: [Ako integrovať systémy kliník s FHIR backendom](https://developers.anpheros.com/sk/guides/integrate-clinic-systems-fhir). Tok súhlas → laboratórium `Observation` zapísaný projektom kliniky → notifikácia v aplikácii pacienta bol precvičený end-to-end s testovacím projektom kliniky. ## Zariadenia a nositeľné zariadenia Merania zo zariadení sú `Observation`s s `author_type: "device"` a kódom LOINC — srdcová frekvencia, krvný tlak, SpO₂, hmotnosť, glukóza, kroky, dĺžka spánku a iné ([FHIR code systems](https://developers.anpheros.com/sk/guides/fhir-code-systems)). Anpheros Daily zapisuje denné súhrny, ktoré číta z Apple Health a Health Connect, ako Observations rovnakým spôsobom. Anpheros sa nepripája priamo ku cloudom predajcov zariadení; vaša aplikácia alebo backend číta zariadenie a zapisuje výsledok. Ako čítať Apple Health, Health Connect a Samsung Health a mapovať každú metriku na LOINC: [Wearable data in FHIR](https://developers.anpheros.com/sk/guides/wearable-data-fhir). ## Aplikácie tretích strán: prístup so súhlasom Aplikácia, ktorá chce získať údaje, ktoré osoba už uchováva v Anpheros, sa zaregistruje raz a požiada o súhlas prostredníctvom OAuth 2.1 s PKCE (SMART on FHIR standalone launch): 1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — hosťovaná stránka súhlasu; 2. osoba si vyberie záznam a dobu trvania (30, 90, 180 alebo 365 dní); 3. `POST /oauth/token` si vymení kód za prístupový token (30 minút) a rotujúci obnovovací token (30 dní); 4. aplikácia vidí iba tohto pacienta, iba v rámci svojich scopes, pod vlastným párovým ID. [Autentifikácia a OAuth](https://developers.anpheros.com/sk/guides/authentication) ## Udalosti: reagovanie na zmeny Namiesto zisťovania stavu (polling) si zaregistrujte webhook. Dodávky sú podpísané pomocou HMAC-SHA256, opakujú sa s postupným zvyšovaním oneskorenia (backoff) až do 24 hodín a obsahujú ID, nikdy nie klinický obsah. Keď iný projekt zapíše do záznamu, ku ktorému máte prístup, udalosť to oznámi (`data.external: true`, so zdrojom). [Webhooks](https://developers.anpheros.com/sk/guides/webhooks) ## SDK TypeScript (`@anpheros/sdk`) a Dart / Flutter (`anpheros_sdk`) SDK implementujú všetko vyššie uvedené — import laboratórnych výsledkov (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth s PKCE, správu webhookov a overenie podpisov. [SDK](https://developers.anpheros.com/sk/guides/sdks) ## Čo nie je dostupné - Hotové konektory pre špecifické nemocničné EHR alebo laboratórne informačné systémy; integrácie sú budované proti API. - SMART EHR spustenie (spustenie v rámci EHR); podporované je iba samostatné spustenie. - Priame integrácie s dodávateľmi zariadení. ## Súvisiace - [Ako integrovať klinické systémy s FHIR backendom](https://developers.anpheros.com/sk/guides/integrate-clinic-systems-fhir): podrobný návod pre klinické EMR systémy - [Ako normalizovať lekárske údaje](https://developers.anpheros.com/sk/guides/normalize-medical-data): kódy, jednotky, dátumy, duplicity, validácia - [Ako importovať laboratórne výsledky do FHIR záznamu](https://developers.anpheros.com/sk/guides/import-lab-results-fhir): podrobný návod s CSV a HL7 v2 - [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability) - [Zdravotnícke API](https://developers.anpheros.com/sk/guides/healthcare-api) - [Architektúra](https://developers.anpheros.com/sk/guides/architecture) - [Prípady použitia](https://developers.anpheros.com/sk/guides/use-cases)