API. Создание/обновление настроек сертификата для мероприятия (EventSession), PUT

PUT /certificate-settings

Метод HTTP

PUT

URL

https://userapi.mts-link.ru/v3/eventsessions/{eventSessionId}/certificate-settings

eventSessionId - ID мероприятия

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • enabled - Включены ли сертификаты
  • certificateFields - Массив полей сертификата
  • certificateFields[].title - Название поля
  • issueConditions - Условия выдачи сертификата

       - activityPercent — условие по проценту активности
       type = activityPercent
       value - процент активности, допустимые значения: 25, 50, 70, 90

        - fillForm — условие по заполнению формы
       type = fillForm
       formUrl - Ссылка на Линк форму
       formTitle - Название формы

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • backgroundFileId - ID файла фона

ОТВЕТЫ

204 - Настройки сертификата сохранены

401 - Пользователь не авторизован

403 - Нет прав на редактирование мероприятия

404 - Мероприятие не найдено / Файл фона не найден / Мероприятие завершено / Вебинар доступен только с регистрацией / Отсутствует поле email

ВОЗМОЖНЫЕ ОШИБКИ

401 UNAUTHORIZED - Пользователь не авторизован. Отсутствует или невалиден x-auth-token 

404 NOT_FOUND - Шаблон мероприятия с указанным eventId не найден 

403 ACCESS_FOR_EDIT_DENIED - У пользователя нет прав на редактирование шаблона мероприятия. Пользователь не является владельцем или администратором 

404 BACKGROUND_FILE_NOT_FOUND - Файл фона с указанным backgroundFileId не найден в файловой системе 

403 ACCESS_TO_BACKGROUND_FILE_DENIED - У пользователя нет доступа к файлу фона. Файл принадлежит другому пользователю 

400 VALIDATION_ERROR - Передано недопустимое значение процента активности. Допустимы только 25, 50, 70 или 90 

400  EVENT_FINISHED - Шаблон мероприятия завершен. Нельзя изменять настройки сертификата для завершённого мероприятия 

400 WEBINAR_CERTIFICATE_AVAILABLE_ON_EVENT_WITH_REGISTRATION - Сертификат доступен только для вебинаров с регистрацией. Мероприятие не имеет включённой регистрации 

400 WEBINAR_CERTIFICATE_IS_NOT_AVAILABLE_WITHOUT_EMAIL_FIELD - Сертификат доступен только для мероприятий с включенным полем "Email" в форме регистрации 

Пример запроса

 curl --location --request PUT 'https://userapi.mts- link.ru/eventsessions/{eventSessionId}/certificate-settings' \ 
--header 'x-auth-token: {Token}' \ 
--header 'Content-Type: application/x-www-form-urlencoded' \ 
--form 'enabled="true"' \ 
--form 'backgroundFileId="456"' \ 
--form 'certificateFields[0][title]="Имя участника"' \ 
--form 'certificateFields[1][title]="Должность"' \ 
--form 'issueConditions[0][type]="activityPercent"' \ 
--form 'issueConditions[0][value]="25"' \ 
--form 'issueConditions[1][type]="fillForm"' \ 
--form 'issueConditions[1][formUrl]="https://my.mts-link.ru/forms/1f139620-897c-6746-bcdd-04421acbfbda"' \ 
--form 'issueConditions[1][formTitle]="Опрос после мероприятия"' \

👆 На этом пока всё