Platforma na správu súhlasu pacienta: ako funguje súhlas, rozsahy, platnosť a odvolanie v API pre zdravotné údaje

Súhlas je časťou zdravotníckeho produktu, ktorú nikto nechce budovať a všetci sú na ňu auditovaní. „Používateľ zaškrtol políčko pri registrácii“ nespĺňa článok 9 GDPR, neprežije kontrolu ochrany údajov a nedovolí osobe odvolať prístup z jednej aplikácie bez toho, aby zrušila svoj účet. Tento návod popisuje, čo musí platforma na správu súhlasu pacienta robiť a ako to robí Anpheros Platform, aby ste ju mohli znovu použiť namiesto toho, aby ste ju museli opätovne budovať.

Technická verzia pre vývojárov: Platforma na správu súhlasu pacienta · Súhlas na developers.anpheros.com, s požiadavkami, odpoveďami a limitmi. Táto stránka je verzia v bežnom jazyku.

Súhlas ako objekt, nie ako príznak

V Anpheros je súhlas povolenie: jedna osoba, jedna aplikácia, sada rozsahu, účel, platnosť. Vytvára sa, keď osoba schváli prístup na stránke súhlasu, je uvedený tam, kde si ho osoba môže pozrieť, a môže byť kedykoľvek odvolaný. Čítania sa pri každej požiadavke kontrolujú voči nemu.

• Rozsah hovorí, čo aplikácia môže čítať alebo zapisovať: pozorovania, diagnózy, lieky, alergie, dokumenty a podobne, voliteľne zúžené podľa kategórie (napríklad laboratórne výsledky, ale nie symptómy).
• Doba platnosti si vyberá osoba: 30, 90, 180 alebo 365 dní. Neexistuje „navždy“.
• Odvolanie nadobúda účinnosť pri nasledujúcej požiadavke. Aplikácia dostane webhook consent.revoked.
• Účel sa zaznamenáva s povolením a zobrazuje sa osobe.

Ako aplikácia žiada

Prostredníctvom OAuth 2.1 s PKCE, so SMART on FHIR samostatným spustením pre aplikácie, ktoré už hovoria SMART. Osoba sa prihlási, vidí, ktorá aplikácia žiada, aký rozsah a na ako dlho, a schváli alebo zamietne. Aplikácia získa token obmedzený na tohto jedného pacienta a daný rozsah; kľúč projektu nikdy nenahrádza súhlas osoby.

GET  https://platform.anpheros.com/oauth/authorize?client_id=…&scope=patient/Observation.read …
POST https://platform.anpheros.com/oauth/token

Prístupové tokeny platia 30 minút, obnovovacie tokeny 30 dní. Dokumenty na zistenie sú na /.well-known/oauth-authorization-server a /.well-known/smart-configuration.

Čo vidí pacient

GET /me/patients/{id}/grants uvádza každú aplikáciu s prístupom, jej rozsah a platnosť. …/grants/{grant}/access-log uvádza, čo každá z nich čítala alebo zapisovala, pod súhlasom a s vlastným kľúčom projektu. S format=fhir sa denník vracia ako Bundle FHIR R4 zdrojov AuditEvent tvarovaný podľa vzorov IHE Basic Audit Log Patterns. V Anpheros Daily je to obrazovka „Pripojenia“; vaša vlastná aplikácia môže zobraziť to isté.

Čítanie verzus zápis

So súhlasom organizácia vidí celý záznam, vrátane toho, čo napísali iné kliniky, ale môže meniť alebo mazať iba to, čo napísala sama. Každá verzia každého zdroja zaznamenáva projekt, ktorý ju napísal; zápis iným projektom je odmietnutý s vysvetlením. Každý zápis produkuje zdroj Provenance pomenúvajúci aplikáciu, organizáciu, v mene ktorej konala, a osobu.

AI agenti navrhujú, osoba rozhoduje

Zápis vykonaný pod súhlasom osoby aplikáciou registrovanou ako AI agent sa neaplikuje okamžite. Platforma ho overí a odpovie 202 Accepted s ID návrhu; v zázname sa nič nemení. Osoba vidí návrh, čo to je a ktorá aplikácia ho poslala, a prijme alebo zamietne ho. Prijatý návrh sa zapíše presne tak, ako bol odoslaný, a označí sa ako napísaný AI. Takto môže asistent pripojený cez MCP pomôcť doplniť záznam bez toho, aby doň kedykoľvek zapisoval bez dozoru.

Zdieľanie bez aplikácie: SMART Health Links

Osoba môže svoj záznam zdieľať aj prostredníctvom QR kódu alebo odkazu. POST /me/patients/{id}/shl vytvorí SMART Health Link pre núdzovú podmnožinu (alergie, lieky, problémy, očkovania) alebo úplný medzinárodný súhrnný prehľad pacienta, s voliteľným prístupovým kódom a platnosťou. Každé otvorenie je v denníku prístupu a odkaz je možné okamžite vypnúť. Otvorí ho akýkoľvek čitateľ SMART Health Link.

Úplný model so všetkými pravidlami je na developers.anpheros.com/guides/consent-model.

Časté otázky

Je súhlas uložený ako zdroj FHIR Consent?

Povolenie je prevádzkový objekt kontrolovaný pri každej požiadavke; záznam tiež nesie zdroje FHIR Consent a Provenance, takže iné systémy môžu čítať, na čom sa dohodlo a kto čo napísal. Denník prístupu je k dispozícii ako FHIR AuditEvent.

Môže pacient udeliť prístup iba k časti záznamu?

Áno. Rozsah je na typ zdroja, s filtrami kategórií, a osoba si ich vyberá na stránke súhlasu. Aplikácia môže žiadať iba o laboratórne výsledky alebo iba o lieky.

Čo sa stane, keď súhlas vyprší?

Požiadavky v rámci tohto povolenia vracajú od dátumu vypršania platnosti 403. Aplikácia môže požiadať znova; osoba rozhodne znova. Nič sa nemazáva.

Vymazáva odvolanie to, čo aplikácia už prečítala?

Žiadny systém nemôže „odčítať“ údaje. Odvolanie okamžite zastaví ďalší prístup a je zaznamenané; to, čo si aplikácia uložila na svojej strane, sa riadi jej vlastnými povinnosťami podľa GDPR.

Môže klinika pristupovať k záznamu bez súhlasu pacienta?

Projekt vidí pacientov, ktorých si sám vytvoril. Čítanie záznamu vytvoreného inde vyžaduje povolenie osoby. Neexistuje žiadne administratívne prepísanie.