# Zdravotnické integrace > Dnes podporované integrační vzory: laboratorní zprávy v jednom volání, kliniky zapisující jménem organizace, zařízení, souhlas třetích stran s aplikacemi, webhooks a SDK – a co není k dispozici. Source: https://developers.anpheros.com/cs/guides/healthcare-integrations **Zdravotnická integrace propojuje systém, který produkuje nebo potřebuje zdravotnická data – laboratoř, kliniku, zařízení, jinou aplikaci – s pacientovým záznamem.** S Anpheros prochází každá integrace stejným API a stejnými pravidly: data jsou zapisována jako HL7 FHIR R4, připsána svému zdroji, viditelná pacientovi a sdílena s jinými stranami pouze s pacientovým souhlasem. Tato stránka popisuje integrační vzory, které platforma dnes podporuje. [Prozkoumejte adresář integrací Anpheros](https://anpheros.com/integrations), abyste viděli každou integraci s jejím ověřeným stavem (dostupné, beta nebo průvodce pro vývojáře), daty a FHIR zdroji, které si vyměňuje, jejím směrem, autentizací a dokumentací. ## Laboratoře: kompletní zprávy v jednom volání Laboratoř, nebo jakýkoli systém, který uchovává laboratorní zprávy, odešle kompletní zprávu a platforma převede každý výsledek na laboratorní `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** (s rumunskými nebo anglickými hlavičkami, desetinná čárka je přijímána), **HL7 v2 ORU^R01** a **JSON**. - Markery jsou mapovány na **LOINC**, pokud zpráva poskytuje kód nebo název odpovídá terminologii platformy; ostatní si ponechají vlastní kód laboratoře a jsou uvedeny jako `unmapped`. - Každý řádek získá stabilní identifikátor, takže **opakované odeslání stejné zprávy přeskočí již importované položky**. - Až 500 řádků na požadavek; každý výsledek nese původní informace pojmenovávající zdrojový systém a zprávu. Podrobnosti: [Lab connector](https://developers.anpheros.com/cs/guides/lab-connector). ## Kliniky: zápis jménem organizace Kliniky a lidé, kteří v nich pracují, jsou adresářové zdroje (`Organization`, `Practitioner`, `PractitionerRole`). Systém kliniky pak může říci, kdo stojí za každým požadavkem: - `X-Anpheros-Acting-As: PractitionerRole/` — praktikující, který pracuje prostřednictvím vaší aplikace; zapsáno do přístupového logu a zobrazeno pacientovi jménem; - `X-Anpheros-On-Behalf-Of: Organization/` — organizace, pro kterou je zápis proveden; - `X-Anpheros-Author-Ref: Practitioner/` — autor zaznamenaný v `Provenance`. Se souhlasem pacienta si klinika přečte celý záznam, včetně toho, co napsaly jiné organizace, a změní pouze to, co napsala sama. Několik zdrojů lze zapsat atomicky pomocí FHIR `transaction` balíčku (`POST /fhir/R4`). Pracovní příklad, od adresáře k návštěvě zapsané jako jedna transakce: [Jak integrovat klinické systémy s FHIR backendem](https://developers.anpheros.com/cs/guides/integrate-clinic-systems-fhir). Tok souhlas → laboratoř `Observation` zapsaný projektem kliniky → oznámení v aplikaci pacienta byl procvičen end-to-end s testovacím projektem kliniky. ## Zařízení a nositelná elektronika Měření ze zařízení jsou `Observation`s s `author_type: "device"` a kódem LOINC — srdeční frekvence, krevní tlak, SpO₂, hmotnost, glukóza, kroky, délka spánku a další ([FHIR code systems](https://developers.anpheros.com/cs/guides/fhir-code-systems)). Anpheros Daily zapisuje denní souhrny, které čte z Apple Health a Health Connect, jako Observations stejným způsobem. Anpheros se nepřipojuje přímo ke cloudům dodavatelů zařízení; vaše aplikace nebo backend čte zařízení a zapisuje výsledek. Jak číst Apple Health, Health Connect a Samsung Health a mapovat jednotlivé metriky na LOINC: [Wearable data in FHIR](https://developers.anpheros.com/cs/guides/wearable-data-fhir). ## Aplikace třetích stran: přístup se souhlasem Aplikace, která chce získat data, jež má osoba již uložena v Anpheros, se jednou zaregistruje a požádá o souhlas prostřednictvím OAuth 2.1 s PKCE (SMART on FHIR standalone launch): 1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — hostovaná stránka souhlasu; 2. osoba si vybere záznam a dobu trvání (30, 90, 180 nebo 365 dní); 3. `POST /oauth/token` si vymění kód za přístupový token (30 minut) a rotující obnovovací token (30 dní); 4. aplikace vidí pouze tohoto pacienta, pouze v rámci svých rozsahů (scopes), pod vlastním párovým ID. [Autentizace a OAuth](https://developers.anpheros.com/cs/guides/authentication) ## Události: reakce na změny Místo dotazování zaregistrujte webhook. Dodávky jsou podepsány pomocí HMAC-SHA256, opakovaně se pokoušejí s postupným zpožděním po dobu až 24 hodin a obsahují ID, nikdy klinický obsah. Když jiný projekt zapíše do záznamu, ke kterému máte přístup, událost to oznámí (`data.external: true`, se zdrojem). [Webhooks](https://developers.anpheros.com/cs/guides/webhooks) ## SDK TypeScript (`@anpheros/sdk`) a Dart / Flutter (`anpheros_sdk`) SDK implementují vše výše uvedené — import laboratorních výsledků (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth s PKCE, správu webhooků a ověřování podpisů. [SDK](https://developers.anpheros.com/cs/guides/sdks) ## Co není dostupné - Hotové konektory pro specifické nemocniční EHR nebo laboratorní informační systémy; integrace jsou budovány proti API. - SMART EHR spuštění (spuštění uvnitř EHR); je podporováno pouze samostatné spuštění. - Přímé integrace s dodavateli zařízení. ## Související - [Jak integrovat klinické systémy s FHIR backendem](https://developers.anpheros.com/cs/guides/integrate-clinic-systems-fhir): podrobný návod pro klinické EMR - [Jak normalizovat lékařská data](https://developers.anpheros.com/cs/guides/normalize-medical-data): kódy, jednotky, data, duplicity, validace - [Jak importovat laboratorní výsledky do FHIR záznamu](https://developers.anpheros.com/cs/guides/import-lab-results-fhir): podrobný návod s CSV a HL7 v2 - [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability) - [Healthcare API](https://developers.anpheros.com/cs/guides/healthcare-api) - [Architektura](https://developers.anpheros.com/cs/guides/architecture) - [Případy použití](https://developers.anpheros.com/cs/guides/use-cases)