# FHIR platforma: spravovaná FHIR R4 s povolením pacienta

> Spravovaná FHIR R4 platforma: 26 typov zdrojov, vyhľadávanie, história, transakcie, $everything, IPS, SMART launch testovaný pomocou Inferno, súhlas a pôvod, plus jednoduché REST API. Bezplatná sandbox.

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

**Anpheros je FHIR platforma — spravovaná FHIR databáza (úložisko dát), ktorú aplikácie používajú ako svoj FHIR backend: ukladá každý záznam pacienta natívne ako zdroje HL7 FHIR R4 (4.0.1) a sprístupňuje ich na `https://platform.anpheros.com/fhir/R4`,** so súhlasom, pôvodom a auditom pridaným nad rámec štandardu. Aplikácie, ktoré už komunikujú vo formáte FHIR, ju môžu použiť priamo; aplikácie, ktoré nie, môžu použiť jednoduchšie REST API (`/v1`), ktoré číta a zapisuje rovnaké zdroje s rovnakými identifikátormi.

Pre AI aplikácie to robí z Anpheros FHIR backendu, z ktorého pochádza kontext modelu: pozri [LLM aplikácie a zdravotné dáta](https://developers.anpheros.com/sk/guides/llm-healthcare-data).

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

## Čo je HL7 FHIR?

FHIR (Fast Healthcare Interoperability Resources) je štandard HL7 pre výmenu zdravotných dát cez web. Definuje:

- **zdroje** — malé, typizované JSON (alebo XML) dokumenty pre každý klinický koncept: `Patient`, `Observation`, `Condition`, `MedicationStatement`;
- **referencie** medzi nimi (`"subject": {"reference": "Patient/123"}`), takže záznam je graf zdrojov okolo pacienta;
- **REST API** na čítanie, vyhľadávanie, vytváranie, aktualizáciu a mazanie zdrojov so štandardnými vyhľadávacími parametrami;
- **balíky (bundles)** na odosielanie viacerých zdrojov naraz (transakcie) alebo ako dokument (napríklad súhrn pacienta);
- **väzby terminológie**, takže hodnoty nesú kódy zo systémov ako LOINC alebo ICD-10;
- **profily** — obmedzenia pre prípad použitia alebo krajinu, ako napríklad International Patient Summary.

R4 (verzia 4.0.1) je dnes najrozšírenejšia implementovaná verzia. Použitie FHIR ako modelu ukladania — nielen ako exportného formátu — znamená, že neexistuje žiadna prekladová vrstva medzi tým, čo aplikácia zapíše, a tým, čo iný FHIR systém prečíta.

```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": "%"}
}
```

## Vyhlásenie o schopnostiach

`GET /fhir/R4/metadata` vráti CapabilityStatement: podporované typy zdrojov, ich vyhľadávacie parametre a operácie. Je verejné a predstavuje autoritatívny zoznam; nižšie uvedená tabuľka ho odráža k 28. septembru 2026.

## 26 typov zdrojov

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

| Oblasť | Typy zdrojov |
|---|---|
| Pacient a osoby | `Patient`, `RelatedPerson` |
| Merania a výsledky | `Observation` (vitálne funkcie, laboratórne výsledky, symptómy, pohoda, denná aktivita a spánok), `DiagnosticReport` |
| Problémy a starostlivosť | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| Lieky a prevencia | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Dokumenty a dotazníky | `DocumentReference`, `QuestionnaireResponse` |
| Návštevy | `Encounter`, `Appointment` |
| Adresár | `Organization`, `Practitioner`, `PractitionerRole` |
| Správa | `Consent`, `Provenance` |
| Rozširujúci bod | `Basic` |

Každý typ s rozsahom pacienta patrí do priečinka pacienta, takže sa na všetky vzťahujú rozsahy OAuth `Patient/{id}/$everything` na úrovni pacienta a filtre súhlasu. Zdroje adresára (`Organization`, `Practitioner`, `PractitionerRole`) nemajú pacienta; sú čitateľné naprieč projektmi v rovnakom prostredí a meniteľné iba projektom, ktorý ich vytvoril.

## Interakcie a operácie

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

- **Read, search, create, update, delete** na každom podporovanom type; parametre vyhľadávania na typ sú uvedené v CapabilityStatement. Neznáme parametre vyhľadávania sú odmietnuté s `400` namiesto tichého ignorovania.
- **History**: `GET /fhir/R4/{type}/{id}/_history` vracia každú verziu; aktualizácie môžu byť podmienené s `If-Match` (nezodpovedajúca verzia odpovedá `412`).
- **Transactions and batches**: `POST /fhir/R4` s `Bundle` typu `transaction` alebo `batch`.
- **`Patient/{id}/$everything`**: celý compartment jedného pacienta.
- **`Patient/{id}/$summary`**: dokument International Patient Summary (IPS) `Bundle`, v angličtine alebo rumunčine (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: hlási, ako výsledok laboratórneho testu zodpovedá pravidlám HL7 Europe pre laboratórne správy.
- **Paging**: `_count` až do 200; `_revinclude` vracia maximálne 1 000 zdrojov.
- **Idempotency**: `POST` požiadavky akceptujú `Idempotency-Key`; opakovaná požiadavka s rovnakým kľúčom vracia rovnakú odpoveď a nič nevytvára.

```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 a zjednodušené REST API

`/v1` existuje pre vývojárov, ktorí nechcú pracovať priamo s FHIR zdrojmi. Pokrýva pacientov, pozorovania, stavy, lieky, dokumenty, chronologický časový rad a pôvod, plus funkcie platformy (kontext, import laboratórnych výsledkov, webhooks, terminológia). Každý `/v1` objekt nesie svoju `fhir` referenciu, takže aplikácia môže začať s `/v1` a prepnúť na FHIR pre časti, kde potrebuje plný model.

## Štandardy okolo FHIR

`$summary` produkuje International Patient Summary validovaný oficiálnym HL7 validátorom (0 chýb); laboratórne výsledky sú kontrolované podľa laboratórnych pravidiel HL7 Europe (dnes poradné); aplikácie tretích strán sa pripájajú cez SMART on FHIR standalone launch; HL7 v2 `ORU^R01` laboratórne správy sú akceptované ako vstup. Formáty, úrovne a vzory výmeny sú opísané v [Interoperabilita zdravotníckych dát](https://developers.anpheros.com/sk/guides/interoperability); kódové systémy podľa typu zdroja v [FHIR kódové systémy](https://developers.anpheros.com/sk/guides/fhir-code-systems).

## Často kladené otázky

### Čo je FHIR platforma?
Služba, ktorá ukladá zdravotné údaje ako zdroje HL7 FHIR a sprístupňuje ich prostredníctvom štandardného FHIR REST API, pričom pridáva to, čo aplikácie potrebujú okolo štandardu: autorizáciu, súhlas, audit, históriu a operácie ako `$everything` a `$summary`. Anpheros je spravovaná FHIR R4 platforma: voláte ju namiesto prevádzkovania FHIR servera.

### Aký je rozdiel medzi FHIR serverom a FHIR platformou?
FHIR server implementuje FHIR API nad databázou. FHIR platforma ho prevádzkuje za vás a pridáva vrstvu okolo neho — súhlas pacienta, pôvod, záznamy o prístupe, SDK, webhooks, import laboratórnych výsledkov a sandbox — takže aplikácie nemusia tieto časti budovať.

### Ktorú verziu FHIR Anpheros podporuje?
FHIR R4 (4.0.1), s 26 typmi zdrojov uvedenými vo verejnom CapabilityStatement na `/fhir/R4/metadata`.

### Je Anpheros FHIR platforma nezávisle testovaná?
Skupina SMART App Launch STU2 "Standalone Launch" open-source testovacej súpravy Inferno prechádza 22 z 22 testov (k 28. septembru 2026) a International Patient Summary sa validuje s 0 chybami v oficiálnom validátore HL7. Spustenie EHR a export hromadných dát zatiaľ nie sú podporované.

### Môžem používať FHIR platformu zadarmo?
Áno. Sandbox je bezplatný a obsahuje 30 syntetických pacientov na projekt; produkcia začína od 99 € mesačne s prvým mesiacom zadarmo.

### Musím používať FHIR, aby som mohol používať Anpheros?
Nie. Jednoduchšie REST API (`/v1`) číta a zapisuje rovnaké zdroje s rovnakými identifikátormi, takže aplikácia môže začať s plochým JSON a prepnúť na FHIR tam, kde potrebuje plný model.

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

## Súvisiace

- [FHIR sandbox](https://developers.anpheros.com/sk/guides/fhir-sandbox): bezplatný súkromný testovací server FHIR R4
- [International Patient Summary (IPS) vo formáte FHIR](https://developers.anpheros.com/sk/guides/international-patient-summary-fhir)
- [Vysvetlenie pôvodu lekárskych údajov](https://developers.anpheros.com/sk/guides/medical-data-provenance): kto čo napísal a ako to zaznamenať
- [Ako ukladať lekárske záznamy pomocou FHIR R4](https://developers.anpheros.com/sk/guides/store-medical-records-fhir): podrobný návod s príkazom curl
- [FHIR verzus vlastná lekárska databáza](https://developers.anpheros.com/sk/guides/fhir-vs-custom-database): kedy navrhnúť vlastné tabuľky a kedy použiť FHIR
- [Bezplatná databáza a sandbox FHIR](https://developers.anpheros.com/sk/guides/free-fhir-database)
- [Porovnanie Anpheros s inými FHIR servermi](https://developers.anpheros.com/sk/guides/fhir-server-comparison)
- [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability)
- [Kódové systémy FHIR](https://developers.anpheros.com/sk/guides/fhir-code-systems)
- [API pre lekárske údaje](https://developers.anpheros.com/sk/guides/medical-data-api)
- [Vytvorenie zdravotníckej aplikácie](https://developers.anpheros.com/sk/guides/build-a-healthcare-app)
- [Referenčná príručka API (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM verzus FHIR](https://developers.anpheros.com/sk/guides/dicom-vs-fhir): kde FHIR končí a začína lekárske zobrazovanie