Згода — це частина медичного продукту, яку ніхто не хоче створювати, але всі перевіряють. "Користувач поставив галочку під час реєстрації" не відповідає статті 9 GDPR, не витримає перевірку захисту даних і не дозволить людині відкликати доступ з одного додатка без видалення свого облікового запису. Цей посібник описує, що має робити платформа згоди пацієнта та як це робить Anpheros Platform, щоб ви могли її повторно використовувати замість того, щоб створювати з нуля.
Технічна версія для розробників: Платформа згоди пацієнта · Згода на developers.anpheros.com із запитами, відповідями та обмеженнями. Ця сторінка є версією простою мовою.
Згода як об'єкт, а не прапорець
В Anpheros згода — це дозвіл: одна людина, один додаток, набір областей доступу (scopes), мета, термін дії. Вона створюється, коли людина схвалює доступ на сторінці згоди, перелічується там, де людина може її побачити, і може бути відкликана в будь-який час. Читання перевіряються на її відповідність під час кожного запиту.
- Області доступу (Scopes) визначають, що додаток може читати або записувати: спостереження, стани, ліки, алергії, документи тощо, опціонально звужені за категорією (наприклад, результати лабораторних досліджень, але не симптоми).
- Тривалість обирається людиною: 30, 90, 180 або 365 днів. Немає варіанту "назавжди".
- Відкликання набуває чинності з наступним запитом. Додаток отримує webhook
consent.revoked. - Мета записується разом з дозволом і відображається людині.
Як додаток запитує доступ
Через OAuth 2.1 з PKCE, зі стандартним запуском SMART on FHIR для додатків, які вже підтримують SMART. Людина входить у систему, бачить, який додаток запитує доступ, які області доступу та на який термін, і схвалює або відхиляє запит. Додаток отримує токен, обмежений цим конкретним пацієнтом та цими областями доступу; ключ проєкту ніколи не замінює згоду людини.
GET https://platform.anpheros.com/oauth/authorize?client_id=…&scope=patient/Observation.read …
POST https://platform.anpheros.com/oauth/token
Токени доступу діють 30 хвилин, токени оновлення — 30 днів. Документи для виявлення (discovery documents) знаходяться за адресами /.well-known/oauth-authorization-server та /.well-known/smart-configuration.
Що бачить пацієнт
GET /me/patients/{id}/grants перелічує кожен додаток, який має доступ, його області доступу та термін дії. …/grants/{grant}/access-log перелічує, що кожен з них читав або записував, під згодою та з власним ключем проєкту. З параметром format=fhir журнал повертається як Bundle ресурсів FHIR R4 AuditEvent, сформованих за шаблонами IHE Basic Audit Log Patterns. В Anpheros Daily це екран "З'єднання" (Connections); ваш власний додаток може відображати те саме.
Читання проти запису
За наявності згоди організація бачить повний запис, включаючи те, що написали інші клініки, але може змінювати або видаляти лише те, що написала сама. Кожна версія кожного ресурсу записує проєкт, який його створив; запис іншим проєктом відхиляється з поясненням. Кожен запис створює ресурс Provenance, що називає додаток, організацію, від імені якої він діяв, та людину.
ШІ-агенти пропонують, людина вирішує
Запис, зроблений під згодою людини додатком, зареєстрованим як ШІ-агент, не застосовується одразу. Платформа перевіряє його та відповідає 202 Accepted з ідентифікатором пропозиції; у записі нічого не змінюється. Людина бачить пропозицію, що це таке і який додаток її надіслав, і приймає або відхиляє її. Прийнята пропозиція записується точно так, як була надіслана, і позначається як створена ШІ. Ось як помічник, підключений через MCP, може допомогти заповнити запис, ніколи не записуючи до нього без нагляду.
Обмін даними без додатка: SMART Health Links
Людина також може ділитися своїм записом за допомогою QR-коду або посилання. POST /me/patients/{id}/shl створює SMART Health Link для екстреного набору даних (алергії, ліки, проблеми, імунізації) або повний Міжнародний звіт пацієнта (International Patient Summary), з опціональним паролем та терміном дії. Кожне відкриття записується в журналі доступу, і посилання можна вимкнути одразу. Будь-який зчитувач SMART Health Link може його відкрити.
Повна модель з усіма правилами доступна на developers.anpheros.com/guides/consent-model.
Поширені запитання
Чи зберігається згода як ресурс FHIR Consent?
Дозвіл є операційним об'єктом, який перевіряється під час кожного запиту; запис також містить ресурси FHIR Consent та Provenance, щоб інші системи могли прочитати, про що було домовлено та хто що написав. Журнал доступу доступний як FHIR AuditEvent.
Чи може пацієнт надати доступ лише до частини запису?
Так. Області доступу (Scopes) визначаються за типом ресурсу, з фільтрами за категоріями, і людина обирає їх на сторінці згоди. Додаток може запитувати лише результати лабораторних досліджень або лише ліки.
Що відбувається, коли термін дії згоди закінчується?
Запити за цим дозволом повертають код 403 з моменту закінчення терміну дії. Додаток може запитати знову; людина вирішує знову. Нічого не видаляється.
Чи видаляє відкликання дані, які додаток вже прочитав?
Жодна система не може "відчитати" дані. Відкликання негайно припиняє подальший доступ і записується; те, що додаток зберігав на своїй стороні, регулюється його власними зобов'язаннями згідно з GDPR.
Чи може клініка отримати доступ до запису без згоди пацієнта?
Проєкт бачить пацієнтів, яких він створив сам. Читання запису, створеного іншим проєктом, вимагає дозволу людини. Адміністративного перегляду не існує.
Тримайте свою медичну карту завжди з собою
Anpheros Daily зберігає симптоми, результати аналізів, ліки та документи в одному місці, у стандартному форматі, під вашим контролем. Базовий план безкоштовний.