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

Integrácie v zdravotníctve

Podporované integračné vzory: laboratórne správy jedným hovorom, kliniky zapisujúce v mene organizácie, zariadenia, súhlasené aplikácie tretích strán, webhooks a SDK — a čo nie je k dispozícii.

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

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.

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/<id> — 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/<id> — organizácia, pre ktorú je zápis vykonaný;
• X-Anpheros-Author-Ref: Practitioner/<id> — 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.

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

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

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

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

Č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: podrobný návod pre klinické EMR systémy
• Ako normalizovať lekárske údaje: kódy, jednotky, dátumy, duplicity, validácia
• Ako importovať laboratórne výsledky do FHIR záznamu: podrobný návod s CSV a HL7 v2
• Interoperabilita zdravotníckych údajov
• Zdravotnícke API
• Architektúra
• Prípady použitia

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