Для разработчиков

Ответ на отправку формы

POST/views/{view_id}/submit_response

Закрывает форму сотруднику или показывает ему ошибки под полями. Метод нужен боту, у которого не задан адрес исходящего вебхука: отвечать на вебхук такому боту некуда, и событие view_submit он получает из метода GETИстория событий. Если адрес вебхука задан, отвечайте прямо на вебхук — это проще и не требует опроса журнала.

Идентификаторы view_id и submit_id приходят в теле события. Ответить нужно в течение 5 секунд с момента отправки формы, иначе сотрудник увидит ошибку отправки, а значения полей сохранятся для повторной попытки.

Тело без поля errors закрывает форму как успешно отправленную, с полем errors — показывает текст ошибки под каждым названным полем.

Ответ принимается один раз. Повторный вызов с той же парой view_id и submit_id, как и опоздавший, получает 410 с кодом submit_expired.

Параметры пути

view_id
string
*
Идентификатор представления
Пример:01KAJZ2XDSS2S3DSW9EXJZ0TBV

Тело запроса

application/json
submit_id
string
*
Идентификатор отправки формы из вебхука view_submit
Пример:791a056b-006c-49dd-834b-c633fde52fe8
errors
object
Ошибки заполнения полей. Ключ — name блока, значение — текст ошибки под полем. Без этого поля представление закрывается как успешно отправленное.
Пример:{"date_end":"Дата окончания отпуска не может быть меньше даты начала"}
string

Ответ

200OK
The request has succeeded.
success
boolean
*
Признак успешной обработки
Пример:true
Ответ на отправку формы
pachca views submit-response 01KAJZ2XDSS2S3DSW9EXJZ0TBV \  --submit-id=791a056b-006c-49dd-834b-c633fde52fe8 \  --errors='{"date_end":"Дата окончания отпуска не может быть меньше даты начала"}' \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "success": true}