# Stavění s Anpheros

> Cesta od přístupu k produkci v devíti krocích — autentizace, API, lékařská data, souhlas, FHIR, webhooks, SDK a spuštění — s průvodcem pro každý krok.

Source: https://developers.anpheros.com/cs/guides/build-with-anpheros

**Stavění na Anpheros znamená jeho použití jako vrstvy lékařských dat vaší aplikace: váš produkt volá Anpheros API pro ukládání a čtení záznamů pacientů ve formátu HL7 FHIR R4, pro získání souhlasu pacienta a pro příjem událostí.** Tato stránka je mapou od prvního přístupu k produkci; každý krok odkazuje na podrobný průvodce.

## 1. Získání přístupu

Platforma Anpheros je v soukromé beta verzi. Sandbox je samoobslužný: přihlaste se pomocí Google na dashboardu (`https://platform.anpheros.com/dashboard/`) a klikněte na *Get a sandbox key* — získáte organizaci, sandbox projekt s vlastními 30 syntetickými pacienty a klíč. Přístup do produkčního prostředí je na vyžádání (`contact@anpheros.com`). Další projekty a API klíče vytváříte na dashboardu nebo prostřednictvím Admin API; OAuth aplikace se registrují pomocí `POST /admin/projects/{id}/applications` a webhooks pomocí `POST /v1/webhooks`.

**Projekt** je jednotkou izolace: jeho klíče vidí pouze pacienty, které vytvořil (a se souhlasem, ty, kteří mu udělili přístup).

## 2. Autentizace

| Přihlašovací údaje | Pro | Vypadá jako |
|---|---|---|
| API klíč | vaše servery | `sk_test_…` (sandbox), `sk_live_…` (produkce) |
| OAuth přístupový token | aplikace jednající za jednoho pacienta | `at_…`, platný 30 minut, obnovuje se pomocí rotačního refresh tokenu |

Odešlete jej jako `Authorization: Bearer <credential>`. Klíče se zobrazují jednou a nikdy nepatří do mobilní nebo webové aplikace. → [Autentizace a OAuth](https://developers.anpheros.com/cs/guides/authentication)

## 3. Připojení k API

Základní URL `https://platform.anpheros.com`; REST na `/v1`, FHIR R4 na `/fhir/R4`. Interaktivní reference a specifikace OpenAPI popisují každý koncový bod.

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

→ [Reference API](https://developers.anpheros.com/docs) · [Healthcare API](https://developers.anpheros.com/cs/guides/healthcare-api)

## 4. Vytváření a čtení lékařských dat

Vytvořte pacienta pro každého ze svých uživatelů, zapište pozorování, diagnózy, léky a dokumenty pomocí `Idempotency-Key` a přečtěte si je zpět jako seznamy nebo časovou osu. U každého zápisu uveďte autora (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Začínáme](https://developers.anpheros.com/cs/guides/getting-started) · [API pro lékařská data](https://developers.anpheros.com/cs/guides/medical-data-api) · [Vytvoření zdravotnické aplikace](https://developers.anpheros.com/cs/guides/build-a-healthcare-app)

## 5. Přidání souhlasu

Pro přístup k záznamu, který osoba již uchovává v Anpheros, zaregistrujte OAuth aplikaci s její redirect URI, odešlete osobu na stránku souhlasu s požadovanými scopes a vyměňte kód (PKCE) za tokeny. Osoba si zvolí dobu trvání a může kdykoli odvolat přístup; každé čtení je pro ni viditelné.

→ [Model souhlasu a přístupu](https://developers.anpheros.com/cs/guides/consent) · [Autentizace a OAuth](https://developers.anpheros.com/cs/guides/authentication)

## 6. Použijte FHIR, pokud potřebujete plný model

Typy zdrojů nad rámec REST API — imunizace, procedury, plány péče, alergie, setkání a další, celkem 26 — jsou k dispozici prostřednictvím FHIR R4, spolu s vyhledáváním, historií, transakcemi, `$everything` a International Patient Summary (`$summary`).

→ [Platforma FHIR](https://developers.anpheros.com/cs/guides/fhir) · [Kódové systémy FHIR](https://developers.anpheros.com/cs/guides/fhir-code-systems) · [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability)

## 7. Reagujte na události

Zaregistrujte koncový bod webhooku pro události `resource.*`, `consent.*` nebo `document.finalized` a ověřte `Anpheros-Signature` každého doručení. Laboratorní zprávy lze odeslat jedním voláním do konektoru laboratoře.

→ [Webhooks](https://developers.anpheros.com/cs/guides/webhooks) · [Lab connector](https://developers.anpheros.com/cs/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/cs/guides/healthcare-integrations)

## 8. Použití SDK

`@anpheros/sdk` (TypeScript: Node 18+, prohlížeče, Deno, Bun) a `anpheros_sdk` (Dart / Flutter) pokrývají celé veřejné API se stejnou strukturou, přidávají klíče pro idempotenci k vytváření, opakují pokusy při `429`/`5xx`, obnovují tokeny a implementují tok souhlasu.

```bash
npm install @anpheros/sdk        # or: dart pub add anpheros_sdk
```

→ [SDK](https://developers.anpheros.com/cs/guides/sdks)

## 9. Přechod do produkčního prostředí

- Produkční klíče (`sk_live_`) jsou vydávány ověřeným organizacím s podepsanou smlouvou o zpracování dat.
- Počítejte s omezeními privátní bety: jedna zóna, žádná smluvní SLA, 600 požadavků za minutu na klíč a na IP.
- Zpracovávejte chyby podle typu a uchovávejte `Anpheros-Request-Id` pro podporu.
- Zkontrolujte, jak jsou data chráněna a kde jsou uložena.

→ [Zabezpečení, ochrana soukromí a rezidence dat](https://developers.anpheros.com/cs/guides/security) · [Omezení](https://developers.anpheros.com/cs/guides/limits) · [Chyby](https://developers.anpheros.com/cs/guides/errors) · [Verzování a ukončení podpory](https://developers.anpheros.com/cs/guides/versioning)

## Přidání AI

Pokud váš produkt zahrnuje asistenta nebo agenta AI, kontextové API připraví relevantní část záznamu pro model, který používáte, v rámci rozpočtu tokenů a s každou položkou označenou zdrojem. → [Aplikace AI ve zdravotnictví](https://developers.anpheros.com/cs/guides/ai-healthcare)

## Související

- [Anpheros pro vývojáře](https://developers.anpheros.com/cs/guides/developers)
- [Vývoj softwaru pro zdravotnictví](https://developers.anpheros.com/cs/guides/healthcare-software)
- [Zdravotnické startupy](https://developers.anpheros.com/cs/guides/healthcare-startups)