Завершение задач

Endpoint

POST /bot/forms/{form_id}/tasks/finish

Завершает одну или несколько открытых задач в форме.

Авторизация

Authorization: Bearer <bot_token>
Content-Type: application/json

У бота должен быть доступ к форме с правом закрытия задач.

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

• form_id — ID формы, в которой находятся задачи

Тело запроса

{
  "task_ids": [123, 456]
}

task_ids должен содержать от 1 до 1 000 уникальных положительных целых чисел.

Пример

curl -X POST \
  -H "Authorization: Bearer <bot_token>" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":[123,456]}' \
  https://public-api.hcapp.ee/bot/forms/12/tasks/finish

Тело ответа

{
  "success": true,
  "error_message": null,
  "data": {
    "finished_task_ids": [123, 456]
  }
}

В finished_task_ids возвращаются только задачи, которые относятся к указанной форме и были открыты на момент обработки запроса. Уже завершённые и неизвестные ID задач пропускаются.

Завершение задачи обновляет время её активности, создаёт системный комментарий и запускает стандартную обработку после завершения.

Ошибки

• 401 — отсутствующий, неверный, истёкший или отозванный токен бота.
• 403 No rights — у бота нет права закрывать задачи в форме.
• 422 — task_ids пуст, содержит более 1 000 значений, дубликаты или неположительный ID.
• 429 — превышен лимит запросов.

Для endpoint действует стандартный лимит bot update.