Коды подтверждения присутствия на занятиях

Коды подтверждения присутствия на занятиях

В рамках проверки цифрового следа обучения в проекте «Код Будущего» реализуется контроль присутствия Получателей поддержки на офлайн‑занятиях.

Факт присутствия на занятии подтверждается с использованием специальных цифровых кодов подтверждения. Процедура осуществляется по следующей логике:

1. Получение кода подтверждения Получателем поддержки

Код подтверждения может быть получен одним из способов:

  • В Личном кабинете Получателя поддержки на цифровой платформе Федерального оператора в разделе «Код подтверждения».

Важно! Для авторизации на цифровой платформе Федерального оператора необходимо использовать учетную запись ЕСИА из заявления, поданного на портале Госуслуг.

  • В мессенджере Макс. Для этого Провайдер в LMS на странице каждого офлайн‑занятия размещает кнопку «Получить код подтверждения». При нажатии на кнопку Провайдер отправляет запрос на цифровую платформу Федерального оператора. При получении ответа «200 ОК» необходимо оповестить пользователя о том, что код успешно сгенерирован и направлен в мессенджер Макс. Получатель поддержки получает специальный код в мессенджере Макс.

Важно! Получателю поддержки необходимо подписаться на бот уведомлений, используя учетную запись ЕСИА из заявления, поданного на портале Госуслуг.

Перед генерацией кода проводятся следующие автоматические проверки:

  • при генерации в Личном кабинете Получателя поддержки на цифровой платформе Федерального оператора - на наличие активной заявки в статусе «Одобрен»/«Зачислен» в текущем проекте;
  • при генерации в LMS Провайдера - на наличие у данного Провайдера активной заявки в статусе «Одобрен»/«Зачислен» на указанного Получателя поддержки в текущем проекте (проверка осуществляется по unti_id).

Важно! Сгенерированный код действителен в течение 15 минут.

2. Ввод Получателем поддержки кода подтверждения в LMS Провайдера

Для Получателя поддержки в LMS Провайдера на странице каждого офлайн‑занятия должен быть обеспечен ввод шестизначного кода (ввод с клавиатуры или вставка ранее скопированного кода). Ввод должен быть доступен сразу, без привязки к кнопке генерации кода - на случай, если слушатель получает код на платформе У2035.

По кнопке «Отправить код подтверждения» Провайдер отправляет запрос на цифровую платформу Федерального оператора.

В момент запроса на цифровой платформе Федерального оператора выполняются следующие проверки:

  • соответствие кода Получателю поддержки, для которого он был сгенерирован;
  • не истёк ли 15‑минутный срок с момента генерации кода;
  • не был ли код ранее отправлен на верификацию.

Если проверки пройдены успешно, в ответе Провайдер получает JWT‑токен. Получателю поддержки необходимо отобразить уведомление о том, что код успешно принят.

Важно! Провайдер должен обязательно:

  • сохранить полученный JWT‑токен в привязке к пользователю и занятию;
  • отправить токен в составе цифрового следа обучения Получателя поддержки.

Получить JWT‑токен повторно по тому же коду (или иными путями, кроме описанного метода) невозможно.


Технический блок

Получение доступов

Провайдеру предварительно необходимо получить доступ к системе управления заявками (Enroll):
https://clck.ru/3U6bNN

Описание API‑методов

1. Запрос на генерацию кода

https://otp.2035.university/api/codes?provider_token=*

Тело запроса (Body):

{
  "unti_id": **,
  "project_id": **
}

Передаваемые параметры:

  • provider_token - токен, единый с системой управления заявками (Enroll);
  • unti_id - уникальный идентификатор пользователя на платформе У2035 (Провайдер получает его при авторизации пользователя через систему SSO У2035);
  • project_id - идентификатор проекта «Код Будущего 2026» (значение: 404)


2. Запрос на верификацию кода

https://otp.2035.university/api/codes/verificate?p...

Тело запроса (Body):

{
  "unti_id": ,
  "project_id": ,
  "code": "",
  "uuid": "***"
}

Передаваемые параметры:

  • provider_token - токен, единый с системой управления заявками (Enroll);
  • unti_id - уникальный идентификатор пользователя на платформе У2035 (Провайдер получает его при авторизации пользователя через систему SSO У2035);
  • project_id - идентификатор проекта «Код Будущего 2026» (значение: 404);
  • code - шестизначный код, введённый слушателем;
  • uuid - uuid занятия в Цифровом следе методиста.

Пример успешного ответа

{
 "result": {
  "successful": true,
  "code": 200
 },
 "payload": {
  "jwt": "***"
 }
}