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

API medyczne z zgodą pacjenta

Jak pacjent udziela dostępu do repozytorium poprzez zakresy i czas trwania OAuth 2.1, jak jest to rejestrowane i odwoływane, co zmienia w projekcie aplikacji i jak identyfikatory par oddzielają aplikacje.

API opieki zdrowotnej z zgodą pacjenta to takie, w którym dostęp do rekordu jest udzielany przez pacjenta, w określonym celu, na określony czas, i może być przeglądany oraz wycofywany przez pacjenta, zamiast być jednorazowo decydowany przez organizację posiadającą dane. W Anpheros zgoda nie jest polem, które ustawiasz; jest to mechanizm, dzięki któremu aplikacja w ogóle uzyskuje dostęp do rekordu. Ten przewodnik wyjaśnia, jak to działa dla dewelopera i co zmienia w projekcie aplikacji.

Dwa sposoby dostępu do rekordu

	Dostęp przez organizację	Dostęp udzielony przez pacjenta
Kto autoryzuje	Twoja organizacja, za pomocą klucza API	Pacjent, za pomocą ekranu zgody OAuth 2.1
Typowe zastosowanie	przychodnia lub laboratorium zapisujące wyniki, Twoja własna aplikacja zapisująca w imieniu swoich użytkowników	aplikacja strony trzeciej, asystent AI, narzędzie lekarza, członek rodziny
Zakres	pacjenci utworzeni przez Twoją organizację lub udostępnieni jej	zakresy zaakceptowane przez pacjenta (`patient/Observation.read`, …)
Czas trwania	dopóki klucz jest ważny	czas wybrany przez pacjenta; odnawialny, odwoływalny
Widoczne dla pacjenta	tak, w logu dostępu	tak, z możliwością wycofania

Obie ścieżki prowadzą przez to samo API i ten sam rekord FHIR. Różnica polega na tym, kto posiada klucz do drzwi.

Przepływ zgody, krok po kroku

Twoja aplikacja wysyła pacjenta do punktu końcowego autoryzacji Anpheros z wymaganymi zakresami (scopes) i uzasadnieniem w języku naturalnym.
Pacjent widzi, o co prosisz, wybiera czas trwania i akceptuje lub odrzuca. Ekran jest w języku pacjenta.
Otrzymujesz token dostępu ograniczony do tych zakresów i tego pacjenta. Tokeny mają krótki okres ważności; tokeny odświeżające są ważne tak długo, jak zgoda.
Każde odczytanie i zapisanie za pomocą tego tokenu jest rejestrowane z nazwą Twojej aplikacji. Pacjent widzi log w swojej aplikacji.
Jeśli pacjent wycofa zgodę, następne żądanie zakończy się niepowodzeniem z jasnym komunikatem błędu. Otrzymujesz webhook, abyś mógł przeprowadzić czyszczenie.

Przepływ jest standardowy dla OAuth 2.1 z PKCE i zakresami SMART on FHIR, więc istniejące biblioteki działają. Przewodnik Uwierzytelnianie i OAuth zawiera dokładne parametry, a Model zgody i dostępu zasady, które się za nim kryją.

Co to zmienia w Twojej aplikacji

Wymagasz mniej. Zakresy są per typ zasobu i per kierunek. Aplikacja, która tworzy wykres wagi, wymaga Observation.read, a nie całego rekordu.
Projektujesz z myślą o wycofaniu. Dostęp może zakończyć się w dowolnym momencie. Buforuj niewiele, odczytuj ponownie w razie potrzeby i traktuj błąd cofnięcia dostępu jako normalny stan.
Otrzymujesz zaufanie za darmo. Pacjenci widzą nazwę Twojej aplikacji, do czego ma dostęp i kiedy ostatnio coś odczytała. Aplikacje, które działają poprawnie, są łatwiejsze do zaakceptowania.
Piszesz z pochodzeniem. Wszystko, co zapisujesz, zawiera Twoją aplikację jako autora, a gdy jest to istotne, osobę, w imieniu której działa. Pacjent i inne aplikacje mogą odróżnić Twoje dane od swoich.

Identyfikatory, które nie ujawniają informacji

Każda aplikacja widzi pacjenta pod identyfikatorem parzystym: ta sama osoba ma inny identyfikator w Twojej aplikacji i w innej. Dwie aplikacje nie mogą połączyć swoich danych o osobie bez zgody pacjenta, nawet jeśli obie są zbudowane na Anpheros. Dla Twojego kodu jest to niewidoczne; dla pacjenta jest to różnica między zgodą a formalnością.

Rodziny i opiekunowie

Zgoda rozciąga się na osoby zarządzające danymi innych osób: rodzica dla dziecka, dorosłego dziecka dla starszego rodzica. Rekord pozostaje na koncie, które go utworzyło; inne konta otrzymują dostęp, który może zostać wycofany. Twoja aplikacja widzi ten sam mechanizm zgody, z opiekunem jako osobą akceptującą.

Powiązane

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