Docs HCAPP

Русский

English

Русский

English

Appearance

Log in

Список тасков ​

Endpoint ​

GET /bot/forms/{form_id}/tasks

Возвращает краткие данные тасков из одной формы через bot API.

Этот endpoint проверяет только то, что у bot-пользователя есть доступ к форме.

Auth ​

http
Authorization: Bearer <token>

Path params ​

  • form_id - ID формы

Query params ​

  • limit integer, опционально, по умолчанию 50, min 1, max 50
  • cursor string, опционально, значение из предыдущего ответа pagination.next_cursor
  • created_at_from ISO datetime, опционально
  • created_at_to ISO datetime, опционально
  • primary_date_from ISO datetime, опционально
  • primary_date_to ISO datetime, опционально
  • author_id integer, опционально
  • responsible_id integer, опционально
  • status string, опционально

Что возвращается ​

Ответ возвращает краткие данные тасков, а не полный список task items.

Для каждого таска возвращаются:

  • task_id
  • form_id
  • title
  • author_id
  • responsible_id
  • responsible_ids
  • created_at
  • last_activity
  • is_finished
  • status
  • due_date_at
  • primary_date_value
  • step_id

Чтобы прочитать все items конкретного таска, используйте GET /bot/tasks/{task_id}.

Пример: первая страница ​

http
GET /bot/forms/45/tasks?limit=50
Authorization: Bearer <token>

Пример: следующая страница ​

Используйте pagination.next_cursor из предыдущего ответа.

http
GET /bot/forms/45/tasks?limit=50&cursor={next_cursor}
Authorization: Bearer <token>

Пример: фильтр по дате создания и статусу ​

http
GET /bot/forms/45/tasks?created_at_from=2026-05-01T00:00:00Z&status=new
Authorization: Bearer <token>

Пример: фильтр по primary date и ответственному ​

http
GET /bot/forms/45/tasks?primary_date_from=2026-05-01T00:00:00Z&primary_date_to=2026-05-31T23:59:59Z&responsible_id=11
Authorization: Bearer <token>

Response body ​

Успешный ответ:

json
{
  "success": true,
  "data": {
    "tasks": [
      {
        "task_id": 123,
        "form_id": 45,
        "title": "Task title",
        "author_id": 10,
        "responsible_id": 11,
        "responsible_ids": [11],
        "created_at": "2026-05-04T10:00:00Z",
        "last_activity": "2026-05-04T10:30:00Z",
        "is_finished": false,
        "status": "new",
        "due_date_at": null,
        "primary_date_value": "2026-05-10T00:00:00Z",
        "step_id": 7
      }
    ],
    "pagination": {
      "limit": 50,
      "returned_count": 1,
      "has_more": false,
      "next_cursor": null
    }
  }
}

Rate limit ​

60 запросов за 60 секунд на bot-пользователя и IP.

Типовые ошибки ​

  • 403 Form access not found
  • 400 Invalid cursor
  • 429 Rate limit exceeded. Retry after {seconds} seconds