Hasta onam platformu: sağlık verisi API'sında onam, kapsamlar, geçerlilik süresi ve geri alma nasıl çalışır

Onay, bir sağlık ürününün kimsenin inşa etmek istemediği ama herkesin denetlendiği kısmıdır. "Kullanıcı kayıt sırasında bir kutucuk işaretledi" ifadesi, GDPR Madde 9'u karşılamaz, veri koruma incelemesinden geçmez ve bir kişinin hesabını silmeden bir uygulamadan erişimini kaldırmasına izin vermez. Bu kılavuz, bir hasta onay platformunun ne yapması gerektiğini ve Anpheros Platform'un bunu nasıl yaptığını açıklar, böylece yeniden inşa etmek yerine yeniden kullanabilirsiniz.

Geliştiriciler için teknik sürüm: Hasta onay platformu · Onay developers.anpheros.com adresinde, istekler, yanıtlar ve sınırlar ile birlikte. Bu sayfa, herkesin anlayabileceği dildeki sürümdür.

Onay bir bayrak değil, bir nesne olarak

Anpheros'ta onay bir izindir: bir kişi, bir uygulama, bir dizi kapsam, bir amaç, bir geçerlilik süresi. Kişi onay sayfasında erişimi onayladığında oluşturulur, kişinin görebileceği yerde listelenir ve herhangi bir zamanda geri alınabilir. Okumalar her istekte buna karşı kontrol edilir.

• Kapsamlar, uygulamanın neleri okuyabileceğini veya yazabileceğini belirtir: gözlemler, durumlar, ilaçlar, alerjiler, belgeler vb., isteğe bağlı olarak kategoriye göre daraltılmış (örneğin laboratuvar sonuçları ama semptomlar değil).
• Süre, kişi tarafından seçilir: 30, 90, 180 veya 365 gün. "Sonsuza dek" diye bir şey yoktur.
• Geri alma, bir sonraki istekte yürürlüğe girer. Uygulama bir consent.revoked webhook'u alır.
• Amaç, izinle birlikte kaydedilir ve kişiye gösterilir.

Bir uygulama nasıl ister

OAuth 2.1 ve PKCE aracılığıyla, zaten SMART kullanan uygulamalar için SMART on FHIR bağımsız başlatma ile. Kişi oturum açar, hangi uygulamanın, hangi kapsamları ve ne kadar süreyle istediğini görür ve onaylar veya reddeder. Uygulama, yalnızca o hastayla ve o kapsamlarla sınırlı bir jeton alır; bir proje anahtarı asla bir kişinin onayının yerine geçmez.

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

Erişim jetonları 30 dakika, yenileme jetonları 30 gün geçerlidir. Keşif belgeleri /.well-known/oauth-authorization-server ve /.well-known/smart-configuration adreslerindedir.

Hastanın gördükleri

GET /me/patients/{id}/grants erişimi olan her uygulamayı, kapsamlarını ve geçerlilik süresini listeler. …/grants/{grant}/access-log her birinin ne okuduğunu veya yazdığını, onay kapsamında ve projenin kendi anahtarıyla listeler. format=fhir ile günlük, FHIR R4 AuditEvent kaynaklarının bir Bundle'ı olarak, IHE Temel Denetim Kayıt Kalıplarına göre şekillendirilmiş olarak gelir. Anpheros Daily'de bu "Bağlantılar" ekranıdır; kendi uygulamanız da aynısını gösterebilir.

Okumalar ve yazmalar

Onay ile bir kuruluş, diğer kliniklerin yazdıkları dahil tüm kaydı görür, ancak yalnızca kendisinin yazdıklarını değiştirebilir veya silebilir. Her kaynağın her sürümü, onu yazan projeyi kaydeder; başka bir proje tarafından yapılan bir yazma, bir açıklama ile reddedilir. Her yazma, uygulamayı, adına hareket ettiği kuruluşu ve kişiyi adlandıran bir Provenance kaynağı üretir.

Yapay zeka aracılar önerir, kişi karar verir

Bir kişinin onayı altında bir yapay zeka aracısı olarak kayıtlı bir uygulama tarafından yapılan bir yazma hemen uygulanmaz. Platform bunu doğrular ve bir öneri kimliği ile 202 Accepted yanıtı verir; kayıtta hiçbir değişiklik olmaz. Kişi öneriyi, ne olduğunu ve hangi uygulamanın gönderdiğini görür ve kabul eder veya reddeder. Kabul edilen bir öneri, gönderildiği gibi tam olarak yazılır ve yapay zeka tarafından yazılmış olarak işaretlenir. Bir asistanın MCP aracılığıyla bağlanarak bir kaydı asla denetimsiz yazmadan doldurmaya nasıl yardımcı olabileceği budur.

Uygulama olmadan paylaşım: SMART Health Links

Bir kişi kaydını QR veya bağlantı yoluyla da paylaşabilir. POST /me/patients/{id}/shl, acil durum alt kümesi (alerjiler, ilaçlar, sorunlar, aşılar) veya tam Uluslararası Hasta Özeti için isteğe bağlı bir parola ve geçerlilik süresi ile bir SMART Health Link oluşturur. Her açılış erişim günlüğüne kaydedilir ve bağlantı anında kapatılabilir. Herhangi bir SMART Health Link okuyucu onu açabilir.

Her kuralı içeren tam model, developers.anpheros.com/guides/consent-model adresindedir.

Sık sorulan sorular

Onay, FHIR Onay kaynağı olarak mı saklanır?

İzin, her istekte kontrol edilen operasyonel nesnedir; kayıt ayrıca, diğer sistemlerin neyin kabul edildiğini ve kimin ne yazdığını okuyabilmesi için FHIR Onay ve Provenance kaynaklarını da taşır. Erişim günlüğü FHIR AuditEvent olarak mevcuttur.

Bir hasta kaydın yalnızca bir kısmına erişim verebilir mi?

Evet. Kapsamlar kaynak türü başına, kategori filtreleriyle birlikte gelir ve kişi bunları onay sayfasında seçer. Bir uygulama yalnızca laboratuvar sonuçları veya yalnızca ilaçlar isteyebilir.

Onay süresi dolduğunda ne olur?

Bu izne tabi istekler, geçerlilik süresinden itibaren 403 döndürür. Uygulama tekrar isteyebilir; kişi tekrar karar verir. Hiçbir şey silinmez.

Geri alma, uygulamanın zaten okuduğunu siler mi?

Hiçbir sistem veriyi geri okuyamaz. Geri alma, daha fazla erişimi hemen durdurur ve kaydedilir; uygulamanın kendi tarafında sakladığı veriler, GDPR kapsamındaki kendi yükümlülüklerine tabidir.

Bir klinik, hastanın onayı olmadan bir kayda erişebilir mi?

Bir proje, kendisinin oluşturduğu hastaları görür. Başka yerde oluşturulmuş bir kaydı okumak, kişinin iznini gerektirir. İdari bir geçersiz kılma yoktur.