# Egészségügyi API beteg beleegyezéssel

> Hogyan ad hozzáférést egy rekordhoz a beteg OAuth 2.1 hatókörökön és időtartamokon keresztül, hogyan naplózható és visszavonható, mit változtat egy alkalmazás tervezésén, és hogyan tartja távol egymástól az alkalmazásokat a páros azonosítók.

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

**A beteg beleegyezésével működő egészségügyi API olyan, ahol a beteg ad hozzáférést egy rekordhoz, egy célra, egy időre, és a beteg láthatja és visszavonhatja azt, ahelyett, hogy az adatok tulajdonos szervezete egyszer döntene róla.** Az Anpherosban a beleegyezés nem egy beállítható mező; ez az a mechanizmus, amelyen keresztül egy alkalmazás egyáltalán elérhet egy rekordot. Ez az útmutató elmagyarázza, hogyan működik ez egy fejlesztő számára, és mit változtat egy alkalmazás tervezésén.

## Két út a rekord eléréséhez

| | Szervezeti hozzáférés | Beteg által engedélyezett hozzáférés |
|---|---|---|
| Ki engedélyez | az Ön szervezete, egy API kulcs segítségével | a beteg, egy OAuth 2.1 hozzájárulási képernyőn keresztül |
| Tipikus felhasználás | egy klinika vagy laboratórium eredményeket ír, saját alkalmazása a felhasználói nevében ír | egy harmadik féltől származó alkalmazás, egy AI asszisztens, egy orvosi eszköz, egy családtag |
| Hatókör | azok a betegek, akiket az Ön szervezete hozott létre, vagy amelyeket megosztottak vele | a beteg által elfogadott hatókörök (`patient/Observation.read`, …) |
| Időtartam | amíg a kulcs érvényes | a beteg által választott időtartam; megújítható, visszavonható |
| Látható a beteg számára | igen, a hozzáférési naplóban | igen, visszavonási lehetőséggel |

Mindkét út ugyanazon az API-n és ugyanazon a FHIR rekordon keresztül vezet. A különbség az, hogy ki tartja a kulcsot az ajtóhoz.

## A hozzájárulási folyamat, lépésről lépésre

1. Az Ön alkalmazása elküldi a beteget az Anpheros engedélyezési végpontjára a szükséges scope-okkal és egy egyszerű nyelvezetű indoklással.
2. A beteg látja, mit kér, kiválaszt egy időtartamot, és elfogadja vagy elutasítja. A képernyő a beteg nyelvén jelenik meg.
3. Hozzáférési tokent kap, amely korlátozott az adott scope-okra és a betegre. A tokenek rövid életidejűek; a frissítési tokenek addig érvényesek, amíg a hozzájárulás.
4. Minden ezzel a tokennel végzett olvasási és írási művelet naplózásra kerül az Ön alkalmazásának nevével. A beteg látja a naplót az alkalmazásában.
5. Ha a beteg visszavonja a hozzájárulást, a következő kérés egy világos hibával meghiúsul. Webhookot kap, így tud tisztítani.

A folyamat szabványos OAuth 2.1 PKCE-vel és SMART on FHIR scope-okkal, így a meglévő könyvtárak működnek. Az [Authentication and OAuth](https://developers.anpheros.com/hu/guides/authentication) útmutató tartalmazza a pontos paramétereket, a [Consent and access model](https://developers.anpheros.com/hu/guides/consent) pedig a mögöttes szabályokat.

## Mi változik az alkalmazásában

- **Kevesebbet kérdez.** A hatókörök erőforrástípusonként és irányonként értelmezendők. Egy testsúlyt ábrázoló alkalmazás `Observation.read`-t kérdez, nem a teljes rekordot.
- **Tervezzen a visszavonásra.** A hozzáférés bármikor megszűnhet. Keveset gyorsítótárazzon, olvasson újra szükség szerint, és kezelje a visszavont hibát normál állapotként.
- **Ingyen bizalmat kap.** A betegek látják az Ön alkalmazásának nevét, mire fér hozzá, és mikor olvasott utoljára valamit. A jól működő alkalmazásokat könnyebb elfogadni.
- **Származási információval ír.** Minden, amit ír, az Ön alkalmazását mint szerzőt hordozza, és ha releváns, azt a személyt, akinek a nevében. A beteg és más alkalmazások meg tudják különböztetni az Ön adatait a sajátjuktól.

## Identifikátorok, amelyek nem szivárognak

Minden alkalmazás páronkénti azonosító alatt látja a beteget: ugyanaz a személy más azonosítóval rendelkezik az Ön alkalmazásában és egy másikban. Két alkalmazás nem egyesítheti az egy személyre vonatkozó adataikat a beteg beleegyezése nélkül, még akkor sem, ha mindkettő az Anpheros-ra épül. Az Ön kódja számára ez láthatatlan; a beteg számára ez a különbség a beleegyezés és egy formalitás között.

## Családtagok és gondozók

A hozzájárulás kiterjed azokra is, akik mások helyett kezelik a rekordokat: szülő gyermek helyett, felnőtt gyermek idős szülő helyett. A rekord a létrehozó fiókhoz kapcsolódik; más fiókok hozzáférést kapnak, amelyet visszavonhatnak. Az Ön alkalmazása ugyanazt a hozzájárulási mechanizmust látja, ahol a gondozó az, aki elfogadja.

## Kapcsolódó

- [Hozzájárulási és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent)
- [Hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication)
- [SMART on FHIR backend](https://developers.anpheros.com/hu/guides/smart-on-fhir-backend)
- [Egészségügyi API](https://developers.anpheros.com/hu/guides/healthcare-api)
- [Biztonság, adatvédelem és adattárolás helye](https://developers.anpheros.com/hu/guides/security)