# FHIR platform: felügyelt FHIR R4 beteg hozzájárulással

> Felügyelt FHIR R4 platform: 26 erőforrástípus, keresés, történet, tranzakciók, $everything, IPS, Inferno-tesztelt SMART indítás, hozzájárulás és eredet, valamint egy egyszerű REST API. Ingyenes sandbox.

Source: https://developers.anpheros.com/hu/guides/fhir

**Az Anpheros egy FHIR platform — egy felügyelt FHIR adatbázis (adat tároló), amelyet az alkalmazások FHIR backendként használnak: minden betegrekordot natívan tárol HL7 FHIR R4 (4.0.1) erőforrásokként, és a `https://platform.anpheros.com/fhir/R4` címen teszi elérhetővé,** hozzájárulással, eredettel és auditálással a szabványon felül. Azok az alkalmazások, amelyek már ismerik a FHIR-t, közvetlenül használhatják; azok, amelyek nem, az egyszerűbb REST API-t (`/v1`) használhatják, amely ugyanazokat az erőforrásokat ugyanazokkal az azonosítókkal olvassa és írja.

AI alkalmazások számára ez teszi az Anpheros-t az FHIR backenddé, ahonnan egy modell kontextusa származik: lásd [LLM alkalmazások és egészségügyi adatok](https://developers.anpheros.com/hu/guides/llm-healthcare-data).

<!-- visual:fhir-hero -->

## Mi az az HL7 FHIR?

A FHIR (Fast Healthcare Interoperability Resources) az HL7 szabványa az egészségügyi adatok webes cseréjére. Meghatározza:

- **erőforrásokat** (resources) — kis, típusos JSON (vagy XML) dokumentumokat minden klinikai koncepcióhoz: egy `Patient`, egy `Observation`, egy `Condition`, egy `MedicationStatement`;
- **hivatkozásokat** (references) közöttük (`"subject": {"reference": "Patient/123"}`), így egy rekord az erőforrások grafja egy páciens körül;
- egy **REST API**-t az erőforrások olvasására, keresésére, létrehozására, frissítésére és törlésére, szabványos keresési paraméterekkel;
- **csomagokat** (bundles) több erőforrás egyidejű küldésére (tranzakciók) vagy dokumentumként (például páciens összefoglaló);
- **terminológiai kötéseket** (terminology bindings), így az értékek olyan rendszerek kódjait hordozzák, mint a LOINC vagy az ICD-10;
- **profilokat** (profiles) — korlátozásokat egy használati esethez vagy országhoz, mint például a Nemzetközi Páciens Összefoglaló (International Patient Summary).

A R4 (4.0.1-es verzió) a ma legszélesebb körben implementált kiadás. A FHIR tárolási modellként való használata — nem csak export formátumként — azt jelenti, hogy nincs fordítási réteg aközött, amit egy alkalmazás ír, és amit egy másik FHIR rendszer olvas.

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "4548-4", "display": "Hemoglobin A1c"}]},
  "subject": {"reference": "Patient/…"},
  "effectiveDateTime": "2026-09-01T08:00:00Z",
  "valueQuantity": {"value": 6.4, "unit": "%", "system": "http://unitsofmeasure.org", "code": "%"}
}
```

## Capability statement

`GET /fhir/R4/metadata` visszaadja a CapabilityStatement-et: a támogatott erőforrás-típusokat, azok keresési paramétereit és a műveleteket. Ez nyilvános és az irányadó lista; az alábbi táblázat ezt tükrözi 2026. szeptember 28-án.

## A 26 erőforrástípus

<!-- visual:fhir-map:replace -->

| Terület | Erőforrástípusok |
|---|---|
| Beteg és személyek | `Patient`, `RelatedPerson` |
| Mérések és eredmények | `Observation` (életjelek, laboratóriumi eredmények, tünetek, közérzet, napi aktivitás és alvás), `DiagnosticReport` |
| Problémák és ellátás | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| Gyógyszerek és megelőzés | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Dokumentumok és kérdőívek | `DocumentReference`, `QuestionnaireResponse` |
| Látogatások | `Encounter`, `Appointment` |
| Könyvtár | `Organization`, `Practitioner`, `PractitionerRole` |
| Irányítás | `Consent`, `Provenance` |
| Kiterjesztési pont | `Basic` |

Minden beteg-hatókörű típus a beteg-kompartmenthez tartozik, így a `Patient/{id}/$everything`, a betegszintű OAuth hatókörök és a hozzájárulási szűrők mindegyikre vonatkoznak. A könyvtár erőforrásoknak (`Organization`, `Practitioner`, `PractitionerRole`) nincs betegük; ezek olvashatók a projektek között ugyanabban a környezetben, és csak a létrehozó projekt módosíthatja őket.

## Interakciók és műveletek

<!-- visual:fhir-ops -->

- **Read, search, create, update, delete** minden támogatott típusra; a típusonkénti keresési paraméterek a CapabilityStatement-ben vannak felsorolva. Az ismeretlen keresési paramétereket `400` hibakóddal utasítjuk el, ahelyett, hogy csendben figyelmen kívül hagynánk őket.
- **History**: `GET /fhir/R4/{type}/{id}/_history` minden verziót visszaad; a frissítések feltételesek lehetnek a `If-Match` használatával (verzióeltérés esetén `412` hibakód érkezik).
- **Transactions and batches**: `POST /fhir/R4` `Bundle` típusú `transaction` vagy `batch` kötegekkel.
- **`Patient/{id}/$everything`**: egy páciens teljes tartománya (compartment).
- **`Patient/{id}/$summary`**: egy International Patient Summary (IPS) dokumentum `Bundle`, angol vagy román nyelven (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: jelenti, hogyan felel meg egy laboratóriumi eredmény az HL7 Europe laboratóriumi jelentési szabályainak.
- **Paging**: `_count` legfeljebb 200 erőforrásig; `_revinclude` legfeljebb 1 000 erőforrást ad vissza.
- **Idempotency**: `POST` kérések elfogadnak egy `Idempotency-Key` azonosítót; az azonos kulccsal ismételt kérés ugyanazt a választ adja vissza, és nem hoz létre semmit.

```bash
# latest HbA1c results of one patient, strict FHIR
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" \
     -H "Authorization: Bearer $KEY"

# the patient's International Patient Summary
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" -H "Authorization: Bearer $KEY"
```

## FHIR és az egyszerűbb REST API

A(z) `/v1` azoknak a fejlesztőknek készült, akik nem szeretnének közvetlenül FHIR erőforrásokkal dolgozni. Ez lefedi a betegeket, megfigyeléseket, állapotokat, gyógyszereket, dokumentumokat, egy kronologikus idővonalat és származási információkat, valamint a platform funkcióit (kontextus, laboratóriumi import, webhookok, terminológia). Minden `/v1` objektum tartalmazza a(z) `fhir` hivatkozását, így egy alkalmazás indulhat a(z) `/v1`-vel, és átválthat FHIR-re azokon a részeken, ahol a teljes modellre van szüksége.

## Szabványok a FHIR körül

A(z) `$summary` által előállított Nemzetközi Betegösszefoglaló az hivatalos HL7 validátorral érvényesítve (0 hiba); a laboreredményeket a HL7 Europe laboratóriumi szabályai szerint ellenőrzik (jelenleg tanácsadó jellegűek); harmadik féltől származó alkalmazások SMART on FHIR standalone launch-on keresztül csatlakoznak; HL7 v2 `ORU^R01` laborüzenetek fogadhatók bemenetként. A formátumok, szintek és csere minták a [Egészségügyi adatintegráció](https://developers.anpheros.com/hu/guides/interoperability) dokumentumban vannak leírva; az erőforrástípusonkénti kódrendszerek a [FHIR kódrendszerek](https://developers.anpheros.com/hu/guides/fhir-code-systems) dokumentumban.

## Gyakran ismételt kérdések

### Mi az a FHIR platform?
Egy olyan szolgáltatás, amely az egészségügyi adatokat HL7 FHIR erőforrásokként tárolja, és azokat a szabványos FHIR REST API-n keresztül teszi elérhetővé, kiegészítve azokkal, amikre az alkalmazásoknak a szabványon túl szükségük van: engedélyezés, hozzájárulás, auditálás, előzmények és olyan műveletek, mint a `$everything` és a `$summary`. Az Anpheros egy felügyelt FHIR R4 platform: Ön azt hívja, ahelyett, hogy futtatna egy FHIR szervert.

### Mi a különbség a FHIR szerver és a FHIR platform között?
Egy FHIR szerver implementálja a FHIR API-t egy adatbázis fölött. Egy FHIR platform futtatja azt Önnek, és hozzáadja a köré épülő réteget – beteg hozzájárulás, eredet, hozzáférési naplók, SDK-k, webhookok, laboratóriumi import és egy sandbox –, így az alkalmazásoknak nem kell ezeket a részeket felépíteniük.

### Melyik FHIR verziót támogatja az Anpheros?
FHIR R4 (4.0.1), 26 erőforrás típussal, amelyek a nyilvános CapabilityStatement-ben szerepelnek a `/fhir/R4/metadata` címen.

### Az Anpheros FHIR platform függetlenül tesztelt?
Az open-source Inferno tesztkészlet SMART App Launch STU2 "Standalone Launch" csoportja 22-ből 22 tesztet teljesít (2026. szeptember 28-i futás), és a Nemzetközi Betegösszefoglaló (International Patient Summary) 0 hibával érvényes az HL7 hivatalos validátorában. Az EHR indítás és a tömeges adat export még nem támogatott.

### Használhatom a FHIR platformot ingyen?
Igen. A sandbox ingyenes, és projektenként 30 szintetikus beteget tartalmaz; a termelés havi 49 eurótól indul, az első hónap ingyenes.

### Kell FHIR-t használnom az Anpheros használatához?
Nem. Egy egyszerűbb REST API (`/v1`) ugyanazokat az erőforrásokat olvassa és írja ugyanazokkal az azonosítókkal, így egy alkalmazás lapos JSON-nal kezdheti, és átválthat FHIR-re, ahol a teljes modellre van szüksége.

<!-- visual:cta-fhir -->

## Kapcsolódó

- [FHIR sandbox](https://developers.anpheros.com/hu/guides/fhir-sandbox): ingyenes, privát FHIR R4 tesztszerver
- [Nemzetközi Betegösszefoglaló (IPS) FHIR formátumban](https://developers.anpheros.com/hu/guides/international-patient-summary-fhir)
- [Az orvosi adatok eredetének magyarázata](https://developers.anpheros.com/hu/guides/medical-data-provenance): ki mit írt, és hogyan rögzítsük
- [Orvosi rekordok tárolása FHIR R4 segítségével](https://developers.anpheros.com/hu/guides/store-medical-records-fhir): lépésről lépésre útmutató curl használatával
- [FHIR vs. egyedi orvosi adatbázis](https://developers.anpheros.com/hu/guides/fhir-vs-custom-database): mikor tervezzünk saját táblákat, és mikor használjunk FHIR-t
- [Ingyenes FHIR adatbázis és sandbox](https://developers.anpheros.com/hu/guides/free-fhir-database)
- [Az Anpheros összehasonlítása más FHIR szerverekkel](https://developers.anpheros.com/hu/guides/fhir-server-comparison)
- [Egészségügyi adatok interoperabilitása](https://developers.anpheros.com/hu/guides/interoperability)
- [FHIR kódrendszerek](https://developers.anpheros.com/hu/guides/fhir-code-systems)
- [Orvosi adatok API](https://developers.anpheros.com/hu/guides/medical-data-api)
- [Egészségügyi alkalmazás fejlesztése](https://developers.anpheros.com/hu/guides/build-a-healthcare-app)
- [API referenciák (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM vs FHIR](https://developers.anpheros.com/hu/guides/dicom-vs-fhir): hol ér véget az FHIR, és hol kezdődik az orvosi képalkotás