# Budujte s Anpheros

> Cesta od prístupu k produkcii v deviatich krokoch — autentizácia, API, lekárske dáta, súhlas, FHIR, webhooks, SDK a spustenie — s návodom pre každý krok.

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

**Budovanie na Anpheros znamená jeho použitie ako vrstvy lekárskych dát vašej aplikácie: váš produkt volá Anpheros API na ukladanie a čítanie záznamov pacientov v HL7 FHIR R4, na získanie súhlasu pacienta a na prijímanie udalostí.** Táto stránka je mapou od prvého prístupu k produkcii; každý krok odkazuje na podrobný návod.

## 1. Získajte prístup

Platforma Anpheros je v súkromnej beta verzii. Sandbox je samoobslužný: prihláste sa pomocou Google na ovládacom paneli (`https://platform.anpheros.com/dashboard/`) a stlačte *Získať kľúč sandboxu* — získate organizáciu, sandbox projekt s vlastnými 30 syntetickými pacientmi a kľúč. Prístup do produkcie je na vyžiadanie (`contact@anpheros.com`). Ďalšie projekty a API kľúče vytvoríte na ovládacom paneli alebo prostredníctvom Admin API; OAuth aplikácie sa registrujú pomocou `POST /admin/projects/{id}/applications` a webhooks pomocou `POST /v1/webhooks`.

**Projekt** je jednotka izolácie: jeho kľúče vidia iba pacientov, ktorých vytvoril (a so súhlasom, tých, ktorí mu udelili prístup).

## 2. Autentizácia

| Prihlasovacie údaje | Pre | Vyzerá ako |
|---|---|---|
| API kľúč | vaše servery | `sk_test_…` (sandbox), `sk_live_…` (produkcia) |
| OAuth prístupový token | aplikácia konajúca v mene jedného pacienta | `at_…`, platný 30 minút, obnovovaný pomocou rotujúceho refresh tokenu |

Odošlite ho ako `Authorization: Bearer <credential>`. Kľúče sa zobrazujú raz a nikdy nepatria do mobilnej alebo webovej aplikácie. → [Autentizácia a OAuth](https://developers.anpheros.com/sk/guides/authentication)

## 3. Pripojenie k API

Základná URL `https://platform.anpheros.com`; REST na `/v1`, FHIR R4 na `/fhir/R4`. Interaktívna referenčná dokumentácia a špecifikácia OpenAPI popisujú každý koncový bod.

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

→ [Referenčná dokumentácia API](https://developers.anpheros.com/docs) · [Healthcare API](https://developers.anpheros.com/sk/guides/healthcare-api)

## 4. Vytváranie a čítanie lekárskych údajov

Vytvorte pacienta pre každého z vašich používateľov, zapisujte pozorovania, diagnózy, lieky a dokumenty pomocou `Idempotency-Key` a čítajte ich späť ako zoznamy alebo časovú os. Uveďte autora každého zápisu (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Začíname](https://developers.anpheros.com/sk/guides/getting-started) · [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)

## 5. Pridanie súhlasu

Na získanie prístupu k záznamu, ktorý osoba už uchováva v Anpheros, zaregistrujte OAuth aplikáciu s jej redirect URI, odošlite osobu na stránku súhlasu s požadovanými scopes a vymeňte kód (PKCE) za tokeny. Osoba si vyberie trvanie a môže kedykoľvek odvolať prístup; každé čítanie je pre ňu viditeľné.

→ [Model súhlasu a prístupu](https://developers.anpheros.com/sk/guides/consent) · [Autentizácia a OAuth](https://developers.anpheros.com/sk/guides/authentication)

## 6. Použite FHIR, kde potrebujete plný model

Typy zdrojov nad rámec REST API — imunizácie, procedúry, plány starostlivosti, alergie, stretnutia a iné, celkovo 26 — sú dostupné prostredníctvom FHIR R4, spolu s vyhľadávaním, históriou, transakciami, `$everything` a medzinárodným súhrnom pacienta (International Patient Summary) (`$summary`).

→ [FHIR platforma](https://developers.anpheros.com/sk/guides/fhir) · [FHIR kódové systémy](https://developers.anpheros.com/sk/guides/fhir-code-systems) · [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability)

## 7. Reagujte na udalosti

Zaregistrujte koncový bod webhooku pre udalosti `resource.*`, `consent.*` alebo `document.finalized` a overte `Anpheros-Signature` každej doručenej správy. Laboratórne správy je možné odoslať v jednom volaní do konektora laboratória.

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

## 8. Použite SDK

`@anpheros/sdk` (TypeScript: Node 18+, prehliadače, Deno, Bun) a `anpheros_sdk` (Dart / Flutter) pokrývajú celé verejné API s rovnakou štruktúrou, pridávajú kľúče na zabezpečenie jedinečnosti pri vytváraní, opakujú pokusy pri `429`/`5xx`, obnovujú tokeny a implementujú tok súhlasu.

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

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

## 9. Prechod do produkcie

- Produkčné kľúče (`sk_live_`) sú vydávané overeným organizáciám s podpísanou dohodou o spracovaní údajov.
- Plánujte s ohľadom na obmedzenia súkromnej bety: jedna zóna, žiadna zmluvná SLA, 600 požiadaviek za minútu na kľúč a na IP.
- Spracúvajte chyby podľa typu a uchovávajte `Anpheros-Request-Id` pre podporu.
- Skontrolujte, ako sú dáta chránené a kde sú uložené.

→ [Bezpečnosť, súkromie a lokalita údajov](https://developers.anpheros.com/sk/guides/security) · [Obmedzenia](https://developers.anpheros.com/sk/guides/limits) · [Chyby](https://developers.anpheros.com/sk/guides/errors) · [Verzionovanie a ukončenie platnosti](https://developers.anpheros.com/sk/guides/versioning)

## Pridanie AI

Ak váš produkt obsahuje asistenta alebo agenta s umelou inteligenciou, kontextové API pripraví relevantnú časť záznamu pre model, ktorý používate, v rámci rozpočtu tokenov a s každou položkou označenou podľa zdroja. → [Aplikácie AI v zdravotníctve](https://developers.anpheros.com/sk/guides/ai-healthcare)

## Súvisiace

- [Anpheros pre vývojárov](https://developers.anpheros.com/sk/guides/developers)
- [Vývoj softvéru v zdravotníctve](https://developers.anpheros.com/sk/guides/healthcare-software)
- [Zdravotnícke startupy](https://developers.anpheros.com/sk/guides/healthcare-startups)