Закрытие и отображение ошибок

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

Вам необходимо оперативно ответить на вебхук (кодом 200 или 400 со списком ошибок). В ином случае, пользователь получит ошибку отправки в интерфейсе Пачки. Все значения полей будут сохранены и пользователь повторит попытку отправки формы.

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

Закрытие представления

Если вы хотите просто закрыть пользователю представление (нет необходимости отображать ошибки), то ответ должен быть HTTP 200 OK. Никакое тело ответа не требуется.

Пример ответа на вебхук для закрытия представления
HTTP/1.1 200 OK
Server
:
nginx/1.14.2
Date
:
Wed, 22 Apr 2025 12:32:29 GMT
Content-Type
:
text/plain; charset=utf-8

Отображение ошибок

Если вы хотите отобразить пользователю ошибки заполнения конкретных полей представления, то ответ должен быть HTTP 400 Bad Request, а тело ответа содержать массив полей с указанием текста ошибки.

Структура исходящего вебхука о заполнении формы
errors object JSON карта ошибок для полей, где каждый ключ - name поля представления.
name string Текст ошибки, который отобразится под полем красным цветом (максимум - 2000 символов)
... ... ...
Пример ответа на вебхук для отображения ошибок
HTTP/1.1 400 Bad Request
Server
:
nginx/1.14.2
Date
:
Wed, 22 Apr 2025 12:32:29 GMT
Content-Type
:
application/json; charset=utf-8
Transfer-Encoding
:
chunked
Connection
:
close
ETag
:
W/"4d63aae1430a3bbd35e95e3db6b364df"
Cache-Control
:
max-age=0, private, must-revalidate
X-Request-Id
:
12f8a05c-c5cf-4a79-8d2f-f82cc477c410
X-Runtime
:
0.117503
Vary
:
Origin
X-Rack-CORS
:
miss; no-origin
{"errors":{"date_end":"Дата окончания отпуска не может быть меньше даты начала","request_doc":"В заявлении не найдена электронная подпись"}}

Пример отображения ошибок в интерфейсе представления: Ошибки отправки