Pro vývojáře

Platforma pro souhlas pacienta: jak funguje souhlas, rozsahy, platnost a odvolání v API pro zdravotní data

Co musí platforma pomáhající se souhlasem pacienta umět: souhlas jako primární objekt s rozsahy a platností, okamžité odvolání, přístupový deník, který si pacient může prohlédnout, a AI pro schválení. Jak to Anpheros implementuje.

od Publikováno Přečteno za 4 min

Souhlas je částí zdravotnického produktu, kterou nikdo nechce vytvářet, ale všichni jsou na ni auditováni. „Uživatel zaškrtl políčko při registraci“ nesplňuje článek 9 GDPR, neprojde kontrolou ochrany osobních údajů a neumožňuje osobě odebrat přístup jedné aplikaci bez smazání jejího účtu. Tento průvodce popisuje, co musí platforma pro souhlas pacienta dělat a jak to dělá Anpheros Platform, abyste ji mohli znovu použít místo toho, abyste ji znovu vytvářeli.

Technická verze pro vývojáře: Platforma pro souhlas pacienta · Souhlas na developers.anpheros.com, s požadavky, odpověďmi a limity. Tato stránka je verze v běžném jazyce.

Souhlas jako objekt, nikoli příznak

V Anpheros je souhlas povolení: jedna osoba, jedna aplikace, sada rozsahů, účel, expirace. Vytvoří se, když osoba schválí přístup na stránce souhlasu, je uveden tam, kde ho osoba může vidět, a lze jej kdykoli odvolat. Čtení jsou proti němu kontrolována při každém požadavku.

  • Rozsahy říkají, co aplikace může číst nebo zapisovat: pozorování, diagnózy, léky, alergie, dokumenty atd., volitelně zúžené podle kategorie (například laboratorní výsledky, ale ne symptomy).
  • Doba trvání si vybírá osoba: 30, 90, 180 nebo 365 dní. Neexistuje „navždy“.
  • Odvolání nabývá účinnosti při dalším požadavku. Aplikace obdrží webhook consent.revoked.
  • Účel je zaznamenán s povolením a zobrazen osobě.

Jak aplikace žádá

Prostřednictvím OAuth 2.1 s PKCE, se SMART on FHIR standalone launch pro aplikace, které již hovoří SMART. Osoba se přihlásí, uvidí, která aplikace žádá, jaké rozsahy a na jak dlouho, a schválí nebo zamítne. Aplikace získá token omezený na tohoto jednoho pacienta a tyto rozsahy; klíč projektu nikdy nenahrazuje souhlas osoby.

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

Přístupové tokeny platí 30 minut, obnovovací tokeny 30 dní. Dokumenty pro zjišťování jsou na /.well-known/oauth-authorization-server a /.well-known/smart-configuration.

Co vidí pacient

GET /me/patients/{id}/grants zobrazí seznam všech aplikací s přístupem, jejich rozsahů a expirace. …/grants/{grant}/access-log zobrazí seznam toho, co každá z nich četla nebo zapisovala, pod souhlasem a s vlastním klíčem projektu. S format=fhir se protokol vrátí jako Bundle zdrojů FHIR R4 AuditEvent tvarovaných podle IHE Basic Audit Log Patterns. V Anpheros Daily je to obrazovka „Connections“; vaše vlastní aplikace může zobrazit totéž.

Čtení versus zápisy

Se souhlasem organizace vidí celý záznam, včetně toho, co napsaly jiné kliniky, ale může měnit nebo mazat pouze to, co napsala sama. Každá verze každého zdroje zaznamenává projekt, který ji zapsal; zápis jiným projektem je odmítnut s vysvětlením. Každý zápis vytvoří zdroj Provenance pojmenovávající aplikaci, organizaci, jejímž jménem jednala, a osobu.

AI agenti navrhují, osoba rozhoduje

Zápis provedený pod souhlasem osoby aplikací registrovanou jako AI agent se neprovede okamžitě. Platforma jej ověří a odpoví 202 Accepted s ID návrhu; v záznamu se nic nezmění. Osoba vidí návrh, co to je a která aplikace jej poslala, a přijme nebo odmítne. Přijatý návrh se zapíše přesně tak, jak byl odeslán, a označí se jako napsaný AI. Takto může asistent připojený přes MCP pomoci doplnit záznam, aniž by do něj kdykoli zapisoval bez dozoru.

Osoba může také sdílet svůj záznam pomocí QR kódu nebo odkazu. POST /me/patients/{id}/shl vytvoří SMART Health Link pro nouzovou podmnožinu (alergie, léky, problémy, imunizace) nebo úplný International Patient Summary, s volitelným heslem a expirací. Každé otevření je v protokolu přístupu a odkaz lze okamžitě vypnout. Může jej otevřít jakýkoli čtečka SMART Health Link.

Kompletní model s každým pravidlem je na developers.anpheros.com/guides/consent-model.

Časté otázky

Povolení je provozní objekt kontrolovaný při každém požadavku; záznam také nese zdroje FHIR Consent a Provenance, takže jiné systémy mohou číst, na čem bylo dohodnuto a kdo co napsal. Protokol přístupu je k dispozici jako FHIR AuditEvent.

Může pacient udělit přístup pouze k části záznamu?

Ano. Rozsahy jsou na typ zdroje, s filtry kategorií, a osoba si je vybírá na stránce souhlasu. Aplikace může požadovat pouze laboratorní výsledky nebo pouze léky.

Co se stane, když souhlas vyprší?

Počínaje expirací budou požadavky v rámci tohoto povolení vracet 403. Aplikace může požádat znovu; osoba rozhodne znovu. Nic se nesmaže.

Maže odvolání to, co aplikace již přečetla?

Žádný systém nemůže data „odčíst“. Odvolání okamžitě zastaví další přístup a je zaznamenáno; to, co aplikace uložila na své straně, se řídí jejími vlastními závazky podle GDPR.

Může klinika přistupovat k záznamu bez souhlasu pacienta?

Projekt vidí pacienty, které sám vytvořil. Čtení záznamu vytvořeného jinde vyžaduje povolení osoby. Neexistuje žádné administrativní přepsání.

Tento návod slouží pouze pro informační účely a nenahrazuje lékařskou radu. Ohledně rozhodnutí o svém zdraví se poraďte se svým lékařem. V případě nouze volejte 112.
O autorovi
Adrian Kereky

Founder of Anpheros. An electronics engineer, he spent six years in autonomous driving, on automotive projects run in partnership with Samsung and NVIDIA, designing the architecture of driver-assistance and AI systems that run on NVIDIA chips with CUDA. He then built Anpheros: the patient-controlled medical record and the HL7 FHIR R4 platform it runs on.

Více o Anpheros a autorovi →

Mějte svůj zdravotní záznam stále u sebe

Anpheros Daily uchovává příznaky, výsledky testů, léky a dokumenty na jednom místě, ve standardním formátu, pod vaší kontrolou. Základní plán je zdarma.

Získat Anpheros Daily