# Integracje medyczne > Obecnie wspierane wzorce integracji: raporty laboratoryjne w jednym wywołaniu, kliniki piszące w imieniu organizacji, urządzenia, aplikacje stron trzecich za zgodą, webhooki i SDK — oraz to, co nie jest dostępne. Source: https://developers.anpheros.com/pl/guides/healthcare-integrations **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](https://anpheros.com/integrations), 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`: ```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 ``` - 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](https://developers.anpheros.com/pl/guides/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/` — 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/` — organizacja, dla której dokonywany jest zapis; - `X-Anpheros-Author-Ref: Practitioner/` — 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](https://developers.anpheros.com/pl/guides/integrate-clinic-systems-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 `Observation`y 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](https://developers.anpheros.com/pl/guides/fhir-code-systems)). 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](https://developers.anpheros.com/pl/guides/wearable-data-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](https://developers.anpheros.com/pl/guides/authentication) ## 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](https://developers.anpheros.com/pl/guides/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](https://developers.anpheros.com/pl/guides/sdks) ## 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](https://developers.anpheros.com/pl/guides/integrate-clinic-systems-fhir): samouczek krok po kroku dla systemów EMR w klinikach - [Jak normalizować dane medyczne](https://developers.anpheros.com/pl/guides/normalize-medical-data): kody, jednostki, daty, duplikaty, walidacja - [Jak importować wyniki laboratoryjne do rekordu FHIR](https://developers.anpheros.com/pl/guides/import-lab-results-fhir): samouczek krok po kroku z użyciem CSV i HL7 v2 - [Interoperacyjność danych w opiece zdrowotnej](https://developers.anpheros.com/pl/guides/interoperability) - [API dla opieki zdrowotnej](https://developers.anpheros.com/pl/guides/healthcare-api) - [Architektura](https://developers.anpheros.com/pl/guides/architecture) - [Przypadki użycia](https://developers.anpheros.com/pl/guides/use-cases)