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

Integracje medyczne

Obsługiwane obecnie wzorce integracji: wyniki badań laboratoryjnych w jednym wywołaniu, przychodnie zapisujące w imieniu organizacji, urządzenia, aplikacje stron trzecich za zgodą, webhooks i SDK — oraz co nie jest dostępne.

Integracja medyczna łączy system, który produkuje lub potrzebuje danych medycznych — laboratorium, klinikę, urządzenie, inną aplikację — z rekordem pacjenta. W Anpheros każda integracja przechodzi przez to samo API i te same zasady: dane są zapisywane jako HL7 FHIR R4, przypisane do ich źródła, widoczne dla pacjenta i udostępniane innym stronom tylko za zgodą pacjenta. Ta strona opisuje wzorce integracji, które platforma wspiera dzisiaj.

Przeglądaj katalog integracji Anpheros, aby zobaczyć każdą integrację z jej zweryfikowanym statusem (dostępna, beta lub przewodnik dla deweloperów), wymienianymi danymi i zasobami FHIR, jej kierunkiem, uwierzytelnianiem i dokumentacją.

Laboratoria: kompletne raporty w jednym wywołaniu

Laboratorium lub dowolny system przechowujący wyniki badań laboratoryjnych wysyła kompletny raport, a platforma przekształca każdy wynik w laboratorium 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

• Formaty: CSV (nagłówki w języku rumuńskim lub angielskim, akceptowana przecinek dziesiętny), HL7 v2 ORU^R01 i JSON.
• Markery są mapowane na LOINC, gdy raport podaje kod lub nazwa pasuje do terminologii platformy; inne zachowują własny kod laboratorium i są wymienione jako unmapped.
• Każdy wiersz otrzymuje stabilny identyfikator, dzięki czemu ponowne wysłanie tego samego raportu pomija to, co zostało już zaimportowane.
• Do 500 wierszy na żądanie; każdy wynik zawiera informacje o pochodzeniu, określające nazwę systemu źródłowego i raportu.

Szczegóły: Lab connector.

Przychodnie: pisanie w imieniu organizacji

Przychodnie i osoby w nich pracujące to zasoby katalogowe (Organization, Practitioner, PractitionerRole). System przychodni może następnie określić, kto stoi za każdym żądaniem:

• X-Anpheros-Acting-As: PractitionerRole/<id> — praktyk pracujący za pośrednictwem Twojej aplikacji; zapisywany w logu dostępu i wyświetlany pacjentowi pod nazwiskiem;
• X-Anpheros-On-Behalf-Of: Organization/<id> — organizacja, dla której dokonywany jest zapis;
• X-Anpheros-Author-Ref: Practitioner/<id> — autor zarejestrowany w Provenance.

Za zgodą pacjenta przychodnia odczytuje cały rekord, w tym to, co napisały inne organizacje, i zmienia tylko to, co sama napisała. Wiele zasobów można zapisać atomowo za pomocą pakietu FHIR transaction (POST /fhir/R4).

Praktyczny przykład, od katalogu do wizyty zapisanej jako jedna transakcja: Jak zintegrować systemy przychodni z backendem FHIR.

Przepływ zgoda → laboratorium Observation zapisane przez projekt przychodni → powiadomienie w aplikacji pacjenta został zrealizowany end-to-end z testowym projektem przychodni.

Urządzenia i urządzenia noszone

Pomiary z urządzeń to Observationy z author_type: "device" i kodem LOINC — tętno, ciśnienie krwi, SpO₂, waga, glukoza, kroki, czas trwania snu i inne (systemy kodów FHIR). Anpheros Daily zapisuje codzienne podsumowania odczytane z Apple Health i Health Connect jako Obserwacje w ten sam sposób. Anpheros nie łączy się bezpośrednio z chmurami dostawców urządzeń; Twoja aplikacja lub backend odczytuje dane z urządzenia i zapisuje wynik. Jak odczytywać dane z Apple Health, Health Connect i Samsung Health oraz mapować każdą metrykę na LOINC: Dane z urządzeń noszonych w FHIR.

Aplikacje stron trzecich: dostęp za zgodą

Aplikacja, która chce uzyskać dostęp do danych przechowywanych przez użytkownika w Anpheros, rejestruje się raz i prosi o zgodę za pomocą protokołu OAuth 2.1 z PKCE (SMART on FHIR standalone launch):

1. GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access — hostowana strona zgody;
2. użytkownik wybiera rekord i okres (30, 90, 180 lub 365 dni);
3. POST /oauth/token wymienia kod na token dostępu (30 minut) i rotujący token odświeżający (30 dni);
4. aplikacja widzi tylko tego pacjenta, tylko w ramach swoich zakresów, pod własnym identyfikatorem parzystym.

Uwierzytelnianie i OAuth

Zdarzenia: reagowanie na zmiany

Zamiast odpytywania, zarejestruj webhook. Dostarczenia są podpisywane za pomocą HMAC-SHA256, ponawiane z wykładniczym opóźnieniem przez maksymalnie 24 godziny i zawierają identyfikatory, nigdy dane kliniczne. Gdy inny projekt zapisuje dane do rekordu, do którego masz dostęp, zdarzenie to sygnalizuje (data.external: true, wraz ze źródłem). Webhooks

SDK

SDK w języku TypeScript (@anpheros/sdk) oraz Dart / Flutter (anpheros_sdk) implementują wszystkie powyższe funkcje — import wyników badań laboratoryjnych (labs.importCsv, labs.importHl7, labs.importItems), OAuth z PKCE, zarządzanie webhookami oraz weryfikację podpisów. SDK

Czego nie ma w zestawie

• Gotowych konektorów do konkretnych szpitalnych systemów EHR lub laboratoryjnych; integracje są budowane w oparciu o API.
• Uruchamiania SMART EHR (uruchamianie wewnątrz systemu EHR); obsługiwane jest tylko uruchamianie samodzielne.
• Bezpośrednich integracji z dostawcami urządzeń.

Powiązane tematy

• Jak zintegrować systemy kliniczne z backendem FHIR: samouczek krok po kroku dla systemów EMR w klinikach
• Jak normalizować dane medyczne: kody, jednostki, daty, duplikaty, walidacja
• Jak importować wyniki laboratoryjne do rekordu FHIR: samouczek krok po kroku z użyciem CSV i HL7 v2
• Interoperacyjność danych w opiece zdrowotnej
• API dla opieki zdrowotnej
• Architektura
• Przypadki użycia

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