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

> Spravovaná platforma FHIR R4: 26 typů zdrojů, vyhledávání, historie, transakce, $everything, IPS, spuštění SMART testované Inferno, souhlas a původ, plus jednoduché REST API. Bezplatná sandbox.

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

**Anpheros je platforma FHIR — spravovaná databáze FHIR (datový úložiště), kterou aplikace používají jako své FHIR backend: ukládá každý záznam pacienta nativně jako zdroje HL7 FHIR R4 (4.0.1) a zpřístupňuje je na `https://platform.anpheros.com/fhir/R4`,** s povolením, původem a auditováním přidaným nad rámec standardu. Aplikace, které již FHIR používají, ji mohou využívat přímo; aplikace, které ne, mohou použít jednodušší REST API (`/v1`), které čte a zapisuje stejné zdroje se stejnými ID.

Pro AI aplikace to činí z Anpherosu FHIR backend, ze kterého pochází kontext modelu: viz [Aplikace LLM a zdravotnická data](https://developers.anpheros.com/cs/guides/llm-healthcare-data).

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

## Co je HL7 FHIR?

FHIR (Fast Healthcare Interoperability Resources) je standard HL7 pro výměnu zdravotnických dat přes web. Definuje:

- **zdroje** — malé, typované JSON (nebo XML) dokumenty pro každý klinický koncept: `Patient`, `Observation`, `Condition`, `MedicationStatement`;
- **reference** mezi nimi (`"subject": {"reference": "Patient/123"}`), takže záznam je graf zdrojů kolem pacienta;
- **REST API** pro čtení, vyhledávání, vytváření, aktualizaci a mazání zdrojů se standardními vyhledávacími parametry;
- **svazky (bundles)** pro odesílání více zdrojů najednou (transakce) nebo jako dokument (například souhrn pacienta);
- **vazby terminologie**, takže hodnoty nesou kódy ze systémů jako LOINC nebo ICD-10;
- **profily** — omezení pro případ použití nebo zemi, jako je International Patient Summary.

R4 (verze 4.0.1) je dnes nejrozšířenější implementovanou verzí. Použití FHIR jako datového modelu — nejen jako exportního formátu — znamená, že neexistuje žádná překladová vrstva mezi tím, co aplikace zapíše, a tím, co jiný FHIR systém přečte.

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

## Prohlášení o schopnostech

`GET /fhir/R4/metadata` vrací Prohlášení o schopnostech (CapabilityStatement): podporované typy zdrojů, jejich vyhledávací parametry a operace. Je veřejné a představuje autoritativní seznam; níže uvedená tabulka jej odráží k 28. září 2026.

## 26 typů zdrojů

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

| Oblast | Typy zdrojů |
|---|---|
| Pacient a osoby | `Patient`, `RelatedPerson` |
| Měření a výsledky | `Observation` (vitální funkce, laboratorní výsledky, symptomy, pohoda, denní aktivita a spánek), `DiagnosticReport` |
| Problémy a péče | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| Léky a prevence | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Dokumenty a dotazníky | `DocumentReference`, `QuestionnaireResponse` |
| Návštěvy | `Encounter`, `Appointment` |
| Adresář | `Organization`, `Practitioner`, `PractitionerRole` |
| Správa | `Consent`, `Provenance` |
| Rozšiřující bod | `Basic` |

Každý typ s rozsahem pacienta patří do oddílu pacienta, takže se na všechny vztahují `Patient/{id}/$everything`, obory OAuth na úrovni pacienta a filtry souhlasu. Zdroje adresáře (`Organization`, `Practitioner`, `PractitionerRole`) nemají pacienta; jsou čitelné napříč projekty ve stejném prostředí a měnitelné pouze projektem, který je vytvořil.

## Interakce a operace

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

- **Read, search, create, update, delete** u každého podporovaného typu; vyhledávací parametry na typ jsou uvedeny v CapabilityStatement. Neznámé vyhledávací parametry jsou odmítnuty s `400` namísto tichého ignorování.
- **History**: `GET /fhir/R4/{type}/{id}/_history` vrací každou verzi; aktualizace lze provést podmíněně s `If-Match` (nesoulad verzí odpovídá `412`).
- **Transactions and batches**: `POST /fhir/R4` s `Bundle` typu `transaction` nebo `batch`.
- **`Patient/{id}/$everything`**: celý compartment jednoho pacienta.
- **`Patient/{id}/$summary`**: dokument International Patient Summary (IPS) `Bundle`, v angličtině nebo rumunštině (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: hlásí, jak se laboratorní výsledek shoduje s pravidly pro laboratorní zprávy HL7 Europe.
- **Paging**: `_count` až do 200; `_revinclude` vrací maximálně 1 000 zdrojů.
- **Idempotency**: `POST` požadavky přijímají `Idempotency-Key`; opakování požadavku se stejným klíčem vrátí stejnou odpověď a nic nevytvoří.

```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 jednodušší REST API

`/v1` existuje pro vývojáře, kteří nechtějí pracovat přímo s FHIR zdroji. Pokrývá pacienty, pozorování, stavy, léky, dokumenty, chronologickou časovou osu a původ, plus funkce platformy (kontext, import z laboratoře, webhooks, terminologie). Každý `/v1` objekt nese svou `fhir` referenci, takže aplikace může začít s `/v1` a přepnout na FHIR pro části, kde potřebuje plný model.

## Standardy kolem FHIR

`$summary` produkuje International Patient Summary ověřený oficiálním HL7 validátorem (0 chyb); laboratorní výsledky jsou kontrolovány podle pravidel HL7 Europe pro laboratoře (dnes pouze poradní); aplikace třetích stran se připojují prostřednictvím SMART on FHIR standalone launch; vstupem jsou přijímány HL7 v2 `ORU^R01` laboratorní zprávy. Formáty, úrovně a vzory výměny jsou popsány v [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability); kódové systémy pro každý typ zdroje v [FHIR kódové systémy](https://developers.anpheros.com/cs/guides/fhir-code-systems).

## Často kladené dotazy

### Co je FHIR platforma?
Služba, která ukládá zdravotní data jako zdroje HL7 FHIR a zpřístupňuje je prostřednictvím standardního FHIR REST API, přičemž přidává to, co aplikace potřebují nad rámec standardu: autorizaci, souhlas, audit, historii a operace jako `$everything` a `$summary`. Anpheros je spravovaná FHIR R4 platforma: voláte ji místo provozování FHIR serveru.

### Jaký je rozdíl mezi FHIR serverem a FHIR platformou?
FHIR server implementuje FHIR API nad databází. FHIR platforma jej provozuje za vás a přidává vrstvu kolem něj — souhlas pacienta, původ dat, protokoly přístupu, SDK, webhooks, import z laboratoří a sandbox — takže aplikace nemusí tyto části vytvářet.

### Kterou verzi FHIR Anpheros podporuje?
FHIR R4 (4.0.1), s 26 typy zdrojů uvedenými ve veřejném CapabilityStatement na `/fhir/R4/metadata`.

### Je Anpheros FHIR platforma nezávisle testována?
Skupina SMART App Launch STU2 "Standalone Launch" v open-source testovacím balíčku Inferno prochází 22 z 22 testů (běh z 28. září 2026) a International Patient Summary se validuje s 0 chybami v oficiálním validátoru HL7. EHR launch a Bulk Data export zatím nejsou podporovány.

### Mohu používat FHIR platformu zdarma?
Ano. Sandbox je zdarma a zahrnuje 30 syntetických pacientů na projekt; produkční prostředí začíná na 99 € měsíčně s prvním měsícem zdarma.

### Musím používat FHIR, abych mohl používat Anpheros?
Ne. Jednodušší REST API (`/v1`) čte a zapisuje stejné zdroje se stejnými ID, takže aplikace může začít s plochým JSON a přepnout na FHIR tam, kde potřebuje plný model.

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

## Související

- [FHIR sandbox](https://developers.anpheros.com/cs/guides/fhir-sandbox): bezplatný soukromý testovací server FHIR R4
- [International Patient Summary (IPS) ve FHIR](https://developers.anpheros.com/cs/guides/international-patient-summary-fhir)
- [Původ lékařských dat vysvětlen](https://developers.anpheros.com/cs/guides/medical-data-provenance): kdo co napsal a jak to zaznamenat
- [Jak ukládat lékařské záznamy pomocí FHIR R4](https://developers.anpheros.com/cs/guides/store-medical-records-fhir): podrobný návod s curl
- [FHIR vs. vlastní lékařská databáze](https://developers.anpheros.com/cs/guides/fhir-vs-custom-database): kdy navrhnout vlastní tabulky a kdy použít FHIR
- [Bezplatná databáze a sandbox FHIR](https://developers.anpheros.com/cs/guides/free-fhir-database)
- [Jak si Anpheros stojí ve srovnání s jinými FHIR servery](https://developers.anpheros.com/cs/guides/fhir-server-comparison)
- [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability)
- [Kódové systémy FHIR](https://developers.anpheros.com/cs/guides/fhir-code-systems)
- [API pro lékařská data](https://developers.anpheros.com/cs/guides/medical-data-api)
- [Vytvoření aplikace pro zdravotnictví](https://developers.anpheros.com/cs/guides/build-a-healthcare-app)
- [Reference API (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM vs FHIR](https://developers.anpheros.com/cs/guides/dicom-vs-fhir): kde FHIR končí a začíná lékařské zobrazování