Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

API de sănătate cu consimțământul pacientului

Cum este acordat accesul la un dosar de către pacient prin scopuri (scopes) și durate OAuth 2.1, cum este înregistrat și revocabil, ce schimbă în designul unei aplicații și cum ID-urile pereche țin aplicațiile separate.

O API pentru sănătate cu consimțământul pacientului este una în care accesul la o înregistrare este acordat de către pacient, în scopul unui anumit scop, pentru o anumită perioadă de timp, și poate fi vizualizat și retras de către pacient, în loc să fie decis o singură dată de către organizația care deține datele. În Anpheros, consimțământul nu este un câmp pe care îl setați; este mecanismul prin care o aplicație ajunge la o înregistrare. Acest ghid explică cum funcționează acest lucru pentru un dezvoltator și ce modificări aduce în designul unei aplicații.

Două modalități de a accesa o înregistrare

	Accesul organizației	Accesul acordat de pacient
Cine autorizează	organizația dvs., printr-o cheie API	pacientul, printr-un ecran de consimțământ OAuth 2.1
Utilizare tipică	o clinică sau un laborator care scrie rezultate, aplicația dvs. care scrie în numele utilizatorilor săi	o aplicație terță, un asistent AI, un instrument medical, un membru al familiei
Domeniu de aplicare	pacienții creați de organizația dvs. sau care i-au fost partajați	domeniile de aplicare pe care pacientul le-a acceptat (`patient/Observation.read`, …)
Durată	cât timp este valabilă cheia	durata aleasă de pacient; reînnoibilă, revocabilă
Vizibil pentru pacient	da, în jurnalul de acces	da, cu posibilitatea de retragere

Ambele căi trec prin același API și prin aceeași înregistrare FHIR. Diferența constă în cine deține cheia ușii.

Fluxul de consimțământ, pas cu pas

Aplicația dvs. trimite pacientul către endpoint-ul de autorizare Anpheros cu scope-urile de care are nevoie și un motiv în limbaj natural.
Pacientul vede ce solicitați, alege o durată și acceptă sau refuză. Ecranul este în limba pacientului.
Primiti un token de acces limitat la acele scope-uri și la acel pacient. Tokenurile au o durată scurtă; tokenurile de reîmprospătare durează cât consimțământul.
Fiecare citire și scriere cu acel token este înregistrată cu numele aplicației dvs. Pacientul vede jurnalul în aplicația sa.
Dacă pacientul retrage consimțământul, următoarea cerere eșuează cu o eroare clară. Primiti un webhook pentru a putea curăța.

Fluxul este standard OAuth 2.1 cu PKCE și scope-uri SMART on FHIR, deci bibliotecile existente funcționează. Ghidul Autentificare și OAuth conține parametrii exacți, iar Modelul de consimțământ și acces regulile din spate.

Ce se schimbă în aplicația dvs.

Solicitați mai puțin. Scope-urile sunt pe tip de resursă și pe direcție. O aplicație care afișează greutatea solicită Observation.read, nu întregul record.
Proiectați pentru retragere. Accesul se poate încheia oricând. Stocați în cache puțin, recitiți când este necesar și tratați eroarea de revocare ca o stare normală.
Obțineți încredere gratuit. Pacienții văd numele aplicației dvs., la ce poate accesa și când a citit ultima dată ceva. Aplicațiile care se comportă bine sunt mai ușor de acceptat.
Scrieți cu proveniență. Tot ceea ce scrieți poartă aplicația dvs. ca autor și, atunci când este relevant, persoana în numele căreia acționați. Pacientul și alte aplicații pot distinge datele dvs. de ale lor.

Identificatori care nu scurg informații

Fiecare aplicație vede un pacient sub un identificator pereche: aceeași persoană are un ID diferit în aplicația dvs. și în alta. Două aplicații nu pot uni datele lor despre o persoană fără consimțământul pacientului, chiar dacă ambele sunt construite pe Anpheros. Pentru codul dvs. acest lucru este invizibil; pentru pacient este diferența dintre consimțământ și o formalitate.

Familii și îngrijitori

Consimțământul se extinde la persoanele care gestionează înregistrări pentru alții: un părinte pentru un copil, un copil adult pentru un părinte în vârstă. Înregistrarea rămâne la contul care a creat-o; alte conturi primesc acces, care poate fi retras. Aplicația dvs. vede același mecanism de consimțământ, cu îngrijitorul ca persoană care acceptă.

Conexe

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card