# Zdravotnícke API s povolením pacienta

> Ako pacient udeľuje prístup k záznamu prostredníctvom rozsahov a trvaní OAuth 2.1, ako je zaznamenaný a odvolateľný, čo to mení v návrhu aplikácie a ako id párov udržujú aplikácie oddelené.

Source: https://developers.anpheros.com/sk/guides/healthcare-api-patient-consent

**Zdravotnícke API s povolením pacienta je také, kde prístup k záznamu udeľuje pacient, na určitý účel, na určitý čas, a pacient ho môže vidieť a odvolať, namiesto toho, aby o ňom raz rozhodla organizácia, ktorá údaje vlastní.** V Anpheros nie je povolenie poľom, ktoré nastavíte; je to mechanizmus, prostredníctvom ktorého aplikácia vôbec získa prístup k záznamu. Táto príručka vysvetľuje, ako to funguje pre vývojára a čo to mení v návrhu aplikácie.

## Dva spôoby prístupu k záznamu

| | Prístup organizácie | Prístup udelený pacientom |
|---|---|---|
| Kto autorizuje | vaša organizácia, prostredníctvom API kľúča | pacient, prostredníctvom obrazovky súhlasu OAuth 2.1 |
| Typické použitie | klinika alebo laboratórium zapisujúce výsledky, vaša vlastná aplikácia zapisujúca v mene svojich používateľov | aplikácia tretej strany, AI asistent, nástroj lekára, člen rodiny |
| Rozsah | pacienti, ktorých vaša organizácia vytvorila alebo ktorí jej boli zdieľaní | rozsahy, ktoré pacient prijal (`patient/Observation.read`, …) |
| Trvanie | kým je kľúč platný | trvanie, ktoré si pacient zvolil; obnoviteľné, odvolateľné |
| Viditeľné pre pacienta | áno, v denníku prístupu | áno, s možnosťou odvolania |

Obidve cesty prechádzajú cez rovnaké API a rovnaký FHIR záznam. Rozdiel je v tom, kto drží kľúč k dverám.

## Tok toku súhlasu, krok za krokom

1. Vaša aplikácia odošle pacienta na autorizačný koncový bod Anpheros s požadovanými scopes a dôvodom v bežnom jazyku.
2. Pacient vidí, o čo žiadate, vyberie si trvanie a prijme alebo odmietne. Obrazovka je v jazyku pacienta.
3. Dostanete prístupový token obmedzený na tieto scopes a tohto pacienta. Tokeny majú krátku životnosť; obnovovacie tokeny vydržia tak dlho, ako súhlas.
4. Každé čítanie a zápis s týmto tokenom je zaznamenané s názvom vašej aplikácie. Pacient vidí záznam vo svojej aplikácii.
5. Ak pacient odvolá súhlas, ďalší požiadavka zlyhá s jasnou chybou. Dostanete webhook, aby ste mohli vykonať čistenie.

Tok je štandardný OAuth 2.1 s PKCE a SMART on FHIR scopes, takže existujúce knižnice fungujú. Sprievodca [Authentication and OAuth](https://developers.anpheros.com/sk/guides/authentication) obsahuje presné parametre a [Consent and access model](https://developers.anpheros.com/sk/guides/consent) pravidlá za ním.

## Čo to mení vo vašej aplikácii

- **Pýtate sa na menej.** Rozsahy sú na typ zdroja a smer. Aplikácia, ktorá zaznamenáva hmotnosť, žiada o `Observation.read`, nie o celý záznam.
- **Navrhujete pre odvolanie.** Prístup sa môže kedykoľvek skončiť. Cacheujte málo, čítajte znovu, keď je to potrebné, a spracujte chybu odvolania ako normálny stav.
- **Získavate dôveru zadarmo.** Pacienti vidia názov vašej aplikácie, k čomu má prístup a kedy naposledy niečo čítala. Aplikácie, ktoré sa správajú dobre, sa ľahšie prijímajú.
- **Píšete s pôvodom.** Všetko, čo napíšete, nesie vašu aplikáciu ako autora a, ak je to relevantné, osobu, v mene ktorej. Pacient a iné aplikácie dokážu rozlíšiť vaše dáta od ich.

## Identifikátory, ktoré neprezrádzajú

Každá aplikácia vidí pacienta pod párovým identifikátorom: tá istá osoba má v tvojej aplikácii iné ID ako v inej. Dve aplikácie nemôžu spojiť svoje údaje o osobe bez súhlasu pacienta, aj keď sú obe postavené na Anpheros. Pre tvoj kód je to neviditeľné; pre pacienta je to rozdiel medzi súhlasom a formalitou.

## Rodiny a opatrovatelia

Súhlas sa rozširuje na osoby, ktoré spravujú záznamy pre iných: rodič pre dieťa, dospelé dieťa pre starého rodiča. Záznam zostáva s účtom, ktorý ho vytvoril; iné účty získajú prístup, ktorý môže byť odvolaný. Vaša aplikácia vidí rovnaký mechanizmus súhlasu, pričom opatrovateľ je osoba, ktorá ho prijíma.

## Súvisiace

- [Model súhlasu a prístupu](https://developers.anpheros.com/sk/guides/consent)
- [Autentizácia a OAuth](https://developers.anpheros.com/sk/guides/authentication)
- [Backend SMART on FHIR](https://developers.anpheros.com/sk/guides/smart-on-fhir-backend)
- [API pre zdravotníctvo](https://developers.anpheros.com/sk/guides/healthcare-api)
- [Bezpečnosť, ochrana súkromia a lokalita údajov](https://developers.anpheros.com/sk/guides/security)