Views

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

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

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

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

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

post/views/{view_id}/submit_response

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/views/{view_id}/submit_response
  • Auth: HTTP bearer

Path parameters

view_idstring required
Example:01KAJZ2XDSS2S3DSW9EXJZ0TBV

Идентификатор представления

Request body

submit_idstring required

Идентификатор отправки формы из вебхука view_submit

errorsobject

Ошибки заполнения полей. Ключ — name блока, значение — текст ошибки под полем. Без этого поля представление закрывается как успешно отправленное.

Example request

{
  "submit_id": "791a056b-006c-49dd-834b-c633fde52fe8",
  "errors": {
    "date_end": "Дата окончания отпуска не может быть меньше даты начала"
  }
}

Response

The request has succeeded.

successboolean required

Признак успешной обработки

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.