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

Integrace ve zdravotnictví

Podporované integrační vzory: laboratorní zprávy jedním požadavkem, kliniky zapisující jménem organizace, zařízení, schválené aplikace třetích stran, webhooks a SDK — a co není k dispozici.

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, 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:

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.

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/<id> — 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/<id> — organizace, pro kterou je zápis proveden;
• X-Anpheros-Author-Ref: Practitioner/<id> — 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.

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 Observations 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). 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.

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

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

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

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: podrobný návod pro klinické EMR
• Jak normalizovat lékařská data: kódy, jednotky, data, duplicity, validace
• Jak importovat laboratorní výsledky do FHIR záznamu: podrobný návod s CSV a HL7 v2
• Interoperabilita zdravotnických dat
• Healthcare API
• Architektura
• Případy použití

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