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

PUT /certificate-settings

МЕТОД HTTP

PUT

URL

https://userapi.mts-link.ru/events/{eventId}/certificate-settings

eventId  - ID шаблона мероприятия


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

  • enabled - Включены ли сертификаты
  • issueConditions - Условия выдачи сертификата

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

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

  • certificateFields - Массив полей сертификата
  • certificateFields[].title - Название поля



 

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

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]="Опрос после мероприятия"' \


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