# Healthcare API: co to je a jak funguje

> Co je healthcare API, jak funguje jeden požadavek, na co se zaměřit a bezplatné FHIR R4 healthcare API s pacientovým souhlasem, původem dat a hostingem v EU — s příklady a často kladenými dotazy.

Source: https://developers.anpheros.com/cs/guides/healthcare-api

**Healthcare API je programové rozhraní, jehož prostřednictvím software čte a zapisuje zdravotnická data — záznamy pacientů, pozorování, diagnózy, léky, dokumenty — a jehož prostřednictvím je autorizován přístup k těmto datům.** Anpheros Platform API je healthcare API nad záznamem HL7 FHIR R4 ovládaným pacientem: aplikace jej používají k ukládání a načítání lékařských dat, k získání souhlasu pacienta a k upozornění na změny.

<!-- visual: hapi-hero -->

## Jak funguje volání zdravotnického API

Bez ohledu na dodavatele projde volání zdravotnického API stejnými kontrolními body: kdo volá, kterého pacienta a jaká data může ovlivnit, kde jsou data uložena, kdo je napsal a kdo potřebuje vědět, že se změnila.

<!-- visual: hapi-request -->

## Druhy zdravotnických API

| Druh | Co vyměňuje | Typické použití |
|---|---|---|
| FHIR REST API | FHIR zdroje přes HTTP (`GET /Observation?patient=…`) | moderní standard pro výměnu klinických dat |
| SMART on FHIR / OAuth | autorizace pro FHIR API | umožňuje aplikacím třetích stran přístup k záznamu s povolením uživatele |
| HL7 v2 messaging | zprávy oddělené znakem pipe (`ORU^R01` pro výsledky, `ADT` pro přijetí) | laboratorní a nemocniční systémy, často přes rozhraní spíše než HTTP |
| Výměna dokumentů | klinické dokumenty (PDF, CDA, FHIR document bundles) | souhrny, propouštěcí zprávy, doporučení |
| Proprietární REST API | JSON specifický pro dodavatele | vlastní mobilní aplikace nebo integrace jediného produktu |

Anpheros kombinuje první dvě jako své jádro, přijímá laboratorní výsledky HL7 v2 jako vstup, ukládá dokumenty s jejich originály a produkuje FHIR document bundles (International Patient Summary). Nabízí také jednodušší REST API nad stejnými daty pro vývojáře, kteří nechtějí pracovat přímo s FHIR.

## Co hledat v API pro zdravotnictví

<!-- visual:hapi-checklist:replace -->

- **Standardní datový model**, aby se data mohla přesouvat mezi systémy bez vlastního mapování.
- **Autorizace, kterou ovládá pacient**, nejen přihlašovací údaje, které ovládá aplikace.
- **Původ (Provenance)**: kdo zapsal každou hodnotu, jménem koho, z jakého systému.
- **Historie**: verze namísto tichého přepisování.
- **Auditovatelnost** čtení, nejen zápisů.
- **Bezpečné opakování pokusů** (idempotence) a **předvídatelné chyby**, protože zdravotní data nesmí být duplikována ani ztracena.
- **Izolace** mezi aplikacemi, které sdílejí stejnou infrastrukturu.
- **Místo uložení dat (Data residency)** odpovídající tomu, kde se pacienti nacházejí.

Zbytek této stránky ukazuje, jak se každý z těchto bodů projevuje v Anpheros API.

## Anpheros API v kostce

| Rozhraní | Základní cesta | Účel |
|---|---|---|
| FHIR R4 | `/fhir/R4` | 26 typů zdrojů; čtení, vyhledávání, vytváření, aktualizace, mazání, historie, transakce, `$everything`, `$summary`, `$validate` |
| REST v1 | `/v1` | pacienti, pozorování, diagnózy, léky, dokumenty, časová osa, původ, kontext AI, import laboratorních výsledků, terminologie, webhooks |
| OAuth 2.1 | `/oauth` | stránka souhlasu, tokeny (PKCE), zrušení, klíče OpenID Connect |
| Stránka pacienta | `/me` | vlastní záznamy osoby, kdo má přístup, protokol přístupu, zrušení |
| Discovery | `/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json` | strojově čitelné popisy API |

Základní URL: `https://platform.anpheros.com`. Sandbox a produkční prostředí sdílejí stejnou URL; klíč určuje datovou rovinu.

### Autentizace

- **API klíče** (`sk_test_…`, `sk_live_…`) pro vaše servery; vidí pacienty, které váš projekt vytvořil.
- **OAuth přístupové tokeny** (`at_…`) pro aplikaci jednající jménem jednoho pacienta na základě souhlasu.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

### Bezpečné zápisy

Požadavky na zápis (write) přijímají `POST`: opakovaný požadavek se stejným klíčem vrátí původní odpověď a nic nevytvoří. Každý zápis obdrží `Idempotency-Key`; typ autora je odeslán v těle požadavku (`Provenance`) nebo v hlavičkách jako `author_type`, `X-Anpheros-Author-Type`, `X-Anpheros-Source-System`, `X-Anpheros-Origin-Id` a `X-Anpheros-On-Behalf-Of`.

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'
```

### Chyby a limity

FHIR koncové body odpovídají pomocí `OperationOutcome`; ostatní pomocí `{"error": {"type", "message", "field"}}`. Každá odpověď obsahuje `Anpheros-Request-Id`. Výchozí limit je 600 požadavků za minutu na klíč a na IP. [Chyby](https://developers.anpheros.com/cs/guides/errors) · [Limity](https://developers.anpheros.com/cs/guides/limits)

### Události

Podepsané webhooks pro `resource.created`, `resource.updated`, `resource.deleted`, `consent.granted`, `consent.revoked`, `document.finalized` a `ping`. [Webhooks](https://developers.anpheros.com/cs/guides/webhooks)

## Volba mezi FHIR a REST v1

Použijte **FHIR**, pokud již pracujete s FHIR, potřebujete typy zdrojů, které `/v1` nepokrývá (například `Immunization`, `Procedure` nebo `CarePlan`), nebo si vyměňujete data s jinými systémy FHIR. Použijte **REST v1** pro aplikační kód, který chce pro běžné případy ploché JSON. Oba čtou a zapisují stejné zdroje se stejnými ID, takže je projekt může kombinovat. [Medical data API](https://developers.anpheros.com/cs/guides/medical-data-api) podrobně popisuje datové operace.

## Často kladené dotazy

### Co je to zdravotnické API?
Programové rozhraní, jehož prostřednictvím software čte a zapisuje zdravotnická data — záznamy pacientů, pozorování, diagnózy, léky a dokumenty — a jehož prostřednictvím je autorizován přístup k těmto datům. Moderní zdravotnická API používají HL7 FHIR R4 pro data a OAuth 2.0 nebo 2.1 se SMART on FHIR pro autorizaci.

### Jaký je rozdíl mezi zdravotnickým API a FHIR API?
FHIR je jeden ze standardů, kterými se zdravotnické API může řídit. FHIR API vyměňuje FHIR zdroje přes REST; zdravotnické API může také přijímat zprávy HL7 v2, dokumenty nebo proprietární JSON. Anpheros nabízí FHIR R4 API a jednodušší REST API nad stejnými daty.

### Existuje bezplatné zdravotnické API pro vývojáře?
Ano. Sandbox Anpheros je zdarma a samoobslužný: přihlaste se pomocí Google, získejte API klíč a pracujte se 30 syntetickými pacienty přes FHIR R4 nebo REST. Produkční prostředí začíná na 99 € měsíčně, první měsíc zdarma.

### Jak pacienti udělují souhlas zdravotnickému API?
Prostřednictvím OAuth 2.1 s PKCE: aplikace odešle osobu na stránku se souhlasem se SMART on FHIR scopes; osoba si vybere, co sdílet a na jak dlouho, může vidět log přístupů a může kdykoli odvolat přístup.

### Kde jsou data uložena?
V Evropské unii: služba a její databáze běží v Google Cloud `europe-west4` (Nizozemsko).

### Které zdravotnické API bych měl zvolit?
Porovnejte datový standard, kdo autorizuje přístup, původ a audit, umístění dat, jak se chovají opakované pokusy a chyby a zda můžete zdarma testovat s realistickými daty. [Platforma zdravotnického API: co obsahuje a jak si vybrat](https://developers.anpheros.com/cs/guides/healthcare-api-platform) převádí tyto otázky do otázek, které můžete položit jakémukoli dodavateli.

<!-- visual:cta-hapi -->

## Související

- [EHR API a API pro lékařské záznamy](https://developers.anpheros.com/cs/guides/ehr-api)
- [Platforma pro API ve zdravotnictví: co zahrnuje a jak si vybrat](https://developers.anpheros.com/cs/guides/healthcare-api-platform)
- [Jak vytvořit API pro zdravotnictví pomocí TypeScript](https://developers.anpheros.com/cs/guides/healthcare-api-typescript): podrobný návod s Express
- [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
- [API pro zdravotnictví s pacientovým souhlasem](https://developers.anpheros.com/cs/guides/healthcare-api-patient-consent)
- [Backend SMART on FHIR](https://developers.anpheros.com/cs/guides/smart-on-fhir-backend)
- [API pro lékařská data](https://developers.anpheros.com/cs/guides/medical-data-api)
- [Platforma FHIR](https://developers.anpheros.com/cs/guides/fhir)
- [Interoperabilita dat ve zdravotnictví](https://developers.anpheros.com/cs/guides/interoperability)
- [Integrace ve zdravotnictví](https://developers.anpheros.com/cs/guides/healthcare-integrations)
- [Referenční příručka API (OpenAPI)](https://developers.anpheros.com/docs) · [Autentizace a OAuth](https://developers.anpheros.com/cs/guides/authentication)