Как настроить отправку данных со своей формы регистрации

Если вы хотите, чтобы участники мероприятия регистрировались через форму на вашем сайте, то можно настроить передачу данных о зарегистрированных участниках в Eventos. Это позволит не закрывать регистрацию перед мероприятием и не мучаться с переносом базы участников из вашей системы в Eventos.

Для этого необходимо:

1. В настройках полей создать те же поля, которые есть на вашей форме регистрации. Подробнее в Как добавить поле для посетителя.

Обязательные поля в Eventos должны соответствовать обязательным полям на вашей форме. Если поле является обязательным, но у него в Eventos задано значение по-умолчанию, то передавать его не обязательно. Например, для поля Группа по-умолчанию проставляется Участник и посетитель это поле может не заполнять.

2. При нажатии пользователем зарегистрироваться на вашей форме настроить отправку данных в API системы Eventos.

Метод: POST URL API: https://app.eventos42.ru/api/form/{token}

Откуда взять токен

• открываем в левом меню вкладку Регистрация

• открываем в верхнем меню вкладку Онлайн, нажимаем на "Форма онлайн регистрации"

• в новой вкладке откроется страница с адресом вида https://form.eventos42.ru/?token=9be1bf5c-631c-4252-9b52-d1406896d647 Всё, что после знака равно и есть токен, который необходимо подставить в URL вместо {token}.

Как сформировать тело запроса

В настройках полей под каждым полем есть имя переменной - это и есть имя параметра, которое надо передать. В качестве значения передаются данные, которые ввел пользователь в вашей форме в соответствующем поле.

Для системных полей, на которые завязана логика имя переменной изменять нельзя. Для текстовых кастомных полей имя переменной можно изменять. Все кастомные поля передаются в объекте "extended".

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

POST https://app.eventos42.ru/api/form/9be1bf5c-631c-4252-9b52-d1406896d647
Content-Type: application/json
{
    "firstName": "Иван",
    "lastName": "Иванович",
    "extended": {
        "company": "Eventos",
        "jobPosition": "тестировщик"
    },
    "phoneNumber": "89217771111"
}

Ответ с http кодом 200 означает, что данные были успешно сохранены в системе.

Возможные ошибки

HTTP код 400:

"error": "VISITOR_DUPLICATE" - пользователь с набором уникальных полей уже есть в системе. Уникальность задаётся в настройках полей.

"error": "VALIDATION_MUST_NOT_BE_NULL" - не заполнено обязательное поле. Обязательность так же указывается в настройках полей.

"error": "VALIDATION_PHONE" - некорректный формат номера телефона.

В поле телефон можно вводить номера, подходящие под формат российских мобильных операторов. Система разпознает номера вида: [phone] 79119998877 89119998877 9119998877 [phone] Все они будут приведены к единому виду [phone]. На номера не подходящие под этот формат вернется ошибка.

Во избежании ошибок такую же валидацию лучше настроить и на своей форме. В случае если валидация данного поля не требуется можно создать обычное текстовое поле для телефонного номера.

"error": "VALIDATION_EMAIL" - некорректный формат почтового адреса.

В поле email должно быть введено значение, удовлетворяющее формату [email protected], где x, y, z – строки произвольной длины из непробельных ASCII-символов. Во избежании ошибок такую же валидацию лучше настроить и на своей форме. В случае если валидация данного поля не требуется можно создать обычное текстовое поле для электронной почты.