# Egészségügyi integrációk

> A ma támogatott integrációs minták: laboratóriumi jelentések egy hívásban, klinikák szervezet nevében történő írása, eszközök, hozzájárulással rendelkező harmadik féltől származó alkalmazások, webhookok és SDK-k – és ami nem elérhető.

Source: https://developers.anpheros.com/hu/guides/healthcare-integrations

**Az egészségügyi integráció összekapcsol egy egészségügyi adatot előállító vagy igénylő rendszert – egy laboratóriumot, egy klinikát, egy eszközt, egy másik alkalmazást – a páciens rekordjával.** Az Anpheros esetében minden integráció ugyanazon az API-n és ugyanazokon a szabályokon keresztül zajlik: az adatok HL7 FHIR R4 formátumban kerülnek rögzítésre, forrásukhoz rendelve, a páciens számára láthatóak, és csak a páciens hozzájárulása esetén oszthatók meg más felekkel. Ez az oldal ismerteti azokat az integrációs mintákat, amelyeket a platform ma támogat.

[Fedezze fel az Anpheros integrációs könyvtárát](https://anpheros.com/integrations), hogy megtekinthesse az egyes integrációkat a hitelesített státuszukkal (elérhető, béta vagy fejlesztői útmutató), a cserélt adatokkal és FHIR erőforrásokkal, irányukkal, hitelesítésükkel és dokumentációjukkal.

## Laboratóriumok: teljes jelentések egy hívásban

Egy laboratórium, vagy bármely laborjelentéseket tároló rendszer, egy teljes jelentést küld, és a platform minden eredményt laboratóriummá `Observation` alakít át:

```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átumok: **CSV** (román vagy angol fejléc, tizedesvessző elfogadva), **HL7 v2 ORU^R01** és **JSON**.
- A markereket a **LOINC**-hoz rendeljük hozzá, ha a jelentés kódot ad meg, vagy a név megegyezik a platform terminológiájával; mások megtartják a labor saját kódját, és `unmapped`-ként szerepelnek.
- Minden sor kap egy stabil azonosítót, így **ugyanazon jelentés újraküldése kihagyja a már importáltakat**.
- Kérésenként legfeljebb 500 sor; minden eredmény tartalmazza a forrásrendszert és a jelentést megnevező származási adatokat.

Részletek: [Lab connector](https://developers.anpheros.com/hu/guides/lab-connector).

## Klinikák: szervezet nevében történő írás

A klinikák és az ott dolgozó emberek könyvtári erőforrások (`Organization`, `Practitioner`, `PractitionerRole`). Egy klinika rendszere ezután meg tudja mondani, ki áll minden egyes kérés mögött:

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — a gyakorló orvos, aki az Ön alkalmazásán keresztül dolgozik; az elérésnaplóba írva és név szerint megjelenítve a beteg számára;
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — a szervezet, amelyre egy írás vonatkozik;
- `X-Anpheros-Author-Ref: Practitioner/<id>` — a szerző, amely a `Provenance`-ben van rögzítve.

A beteg beleegyezésével a klinika elolvassa a teljes rekordot, beleértve azt is, amit más szervezetek írtak, és csak azt változtatja meg, amit maga írt. Több erőforrás írható atomilag egy FHIR `transaction` köteggel (`POST /fhir/R4`).

Egy kidolgozott példa, a könyvtártól egy látogatásig, amelyet egy tranzakcióként írtak le: [Hogyan integrálhatók a klinikai rendszerek FHIR háttérrendszerrel](https://developers.anpheros.com/hu/guides/integrate-clinic-systems-fhir).

A beleegyezés → laboratóriumi `Observation` folyamat, amelyet egy klinikai projekt írt → értesítés a beteg alkalmazásában, end-to-end módon lett végrehajtva egy teszt klinikai projekttel.

## Eszközök és viselhető eszközök

Az eszközök mérései `Observation`-ek `author_type: "device"`-tel és LOINC kóddal – pulzusszám, vérnyomás, SpO₂, súly, glükóz, lépésszám, alvásidőtartam és mások ([FHIR kódrendszerek](https://developers.anpheros.com/hu/guides/fhir-code-systems)). Az Anpheros Daily az Apple Health és a Health Connect alkalmazásokból olvasott napi összefoglalókat ugyanúgy Observations-ként írja. Az Anpheros nem csatlakozik közvetlenül az eszközgyártók felhőibe; az Ön alkalmazása vagy backendje olvassa le az eszközről és írja ki az eredményt. Az Apple Health, a Health Connect és a Samsung Health olvasása, valamint az egyes metrikák LOINC-hoz való hozzárendelése: [Viselhető eszközök adatai FHIR formátumban](https://developers.anpheros.com/hu/guides/wearable-data-fhir).

## Harmadik féltől származó alkalmazások: hozzájárulással történő hozzáférés

Egy alkalmazás, amely a személy Anpherosban tárolt adataira kíváncsi, egyszer regisztrál, és hozzájárulást kér az OAuth 2.1 protokollon keresztül PKCE-vel (SMART on FHIR standalone launch):

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — a tárolt hozzájárulási oldal;
2. a személy kiválasztja a rekordot és az időtartamot (30, 90, 180 vagy 365 nap);
3. `POST /oauth/token` kicseréli a kódot egy hozzáférési tokenre (30 perc) és egy forgó frissítési tokenre (30 nap);
4. az alkalmazás csak azt a beteget látja, csak a hatókörén belül, saját páros azonosítója alatt.

[Hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication)

## Események: változásokra reagálás

A lekérdezés helyett regisztráljon egy webhookot. A kézbesítések HMAC-SHA256-tal vannak aláírva, legfeljebb 24 órán át visszatartással próbálkoznak újra, és azonosítókat hordoznak, soha nem klinikai tartalmat. Amikor egy másik projekt ír egy olyan rekordba, amelyhez hozzáférése van, az esemény ezt jelzi (`data.external: true`, a forrással együtt). [Webhookok](https://developers.anpheros.com/hu/guides/webhooks)

## SDK-k

A TypeScript (`@anpheros/sdk`) és a Dart / Flutter (`anpheros_sdk`) SDK-k megvalósítják a fentieket – laboratóriumi importálás (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth PKCE-vel, webhookok kezelése és aláírás-ellenőrzés. [SDK-k](https://developers.anpheros.com/hu/guides/sdks)

## Mi nem érhető el

- Kész csatlakozók specifikus kórházi EHR-ekhez vagy laboratóriumi információs rendszerekhez; az integrációk az API ellenében épülnek.
- SMART EHR indítás (EHR-en belüli indítás); csak önálló indítás támogatott.
- Közvetlen eszközgyártói integrációk.

## Kapcsolódó

- [Klinikai rendszerek integrálása FHIR backenddel](https://developers.anpheros.com/hu/guides/integrate-clinic-systems-fhir): lépésről lépésre útmutató klinikai EMR-ekhez
- [Orvosi adatok normalizálása](https://developers.anpheros.com/hu/guides/normalize-medical-data): kódok, egységek, dátumok, duplikátumok, validálás
- [Laboreredmények importálása FHIR rekordba](https://developers.anpheros.com/hu/guides/import-lab-results-fhir): lépésről lépésre útmutató CSV és HL7 v2 használatával
- [Egészségügyi adatok interoperabilitása](https://developers.anpheros.com/hu/guides/interoperability)
- [Egészségügyi API](https://developers.anpheros.com/hu/guides/healthcare-api)
- [Architektúra](https://developers.anpheros.com/hu/guides/architecture)
- [Használati esetek](https://developers.anpheros.com/hu/guides/use-cases)
