Get

[POST] .../v1/projecttask/get

Возвращает список задач проектов с фильтрацией и пагинацией.

Входные параметры

Название	Тип данных	Обязательность	Описание
ids	Array of Int64	Необязательный	Массив ID задач
project_ids	Array of Int64	Необязательный	Массив ID проектов
parent_task_ids	Array of Int64	Необязательный	Фильтр по ID родительских задач
responsible_user_ids	Array of Int64	Необязательный	Фильтр по ответственным
client_ids	Array of Int64	Необязательный	Фильтр по связанным CRM-клиентам
deal_ids	Array of Int64	Необязательный	Фильтр по связанным CRM-сделкам
observer_user_ids	Array of Int64	Необязательный	Фильтр по наблюдателям
statuses	Array of Enum	Необязательный	Фильтр по статусам (`New`, `InProgress`, `Done`, `Canceled`)
due_from	Int64	Необязательный	Начало периода срока выполнения (Unix time, сек.)
due_to	Int64	Необязательный	Конец периода срока выполнения (Unix time, сек.)
filters	Array of Filter	Необязательный	Дополнительные условия фильтрации
search	String	Необязательный	Поиск по полям `name` и `description`
limit	Int32	Необязательный	Лимит элементов выборки
offset	Int32	Необязательный	Смещение выборки
sort_orders	Array of BaseSortColumn	Необязательный	Сортировка результата

Filter

Название	Тип данных	Описание
field	String	Имя поля фильтра
operator	Enum	Оператор (`Equal`, `NotEqual`, `Greater`, `Less`, `GreaterOrEqual`, `LessOrEqual`, `Like`, `Exists`, `NotExists`)
value	String	Значение фильтра

BaseSortColumn

Название	Тип данных	Описание
column	String	Имя сортируемого поля
direction	Enum	Направление сортировки: `ASC` или `DESC`

Поля, доступные для сортировки (sort_orders.column):
id, status, project_id, client_id, deal_id, due_date, created_date, created_user_id, closed_user_id, closed_date, name, last_update.

Если в sort_orders не передано ни одного поддерживаемого поля, применяется сортировка по id.

Пример запроса

{
  "project_ids": [12],
  "parent_task_ids": [840],
  "responsible_user_ids": [42],
  "client_ids": [118],
  "deal_ids": [220],
  "statuses": ["InProgress", "New"],
  "due_from": 1762000000,
  "due_to": 1763000000,
  "search": "КП",
  "limit": 50,
  "offset": 0,
  "sort_orders": [
    {
      "column": "due_date",
      "direction": "ASC"
    }
  ]
}

Выходные параметры

Название	Тип данных	Описание
result	Array of ProjectTask	Массив задач
next_offset	Int32	Смещение для следующей страницы
total	Int64	Общее количество элементов

Если задача привязана к CRM-клиенту, в ответе возвращается вложенный объект client с полной моделью клиента.

Пример ответа

{
  "ok": true,
  "result": [
    {
      "id": 845,
      "project_id": 12,
      "parent_task_id": 840,
      "name": "Подготовить финальное КП",
      "description": "Уточнить суммы и сроки",
      "responsible_user_id": 42,
      "deal_id": 220,
      "client": {
        "id": 118,
        "external_id": "ext-118",
        "name": "ООО Ромашка",
        "phone": "+998901112233",
        "email": "client@example.com",
        "photo_url": null,
        "description": null,
        "responsible_user_id": 42,
        "deleted": false,
        "created_user_id": 15,
        "last_update": 1762011100,
        "fields": []
      },
      "chat_id": "f69d8f8f-5d6e-4b70-a0cf-b5206a8b1c1a",
      "observer_user_ids": [5, 7],
      "status": "InProgress",
      "due_date": 1762400000,
      "created_date": 1762000000,
      "attachment_file_ids": [101],
      "inline_file_ids": [103, 104],
      "fields": [],
      "created_user_id": 15,
      "closed_user_id": null,
      "closed_date": null,
      "deleted": false,
      "last_update": 1762011120
    }
  ],
  "next_offset": 50,
  "total": 1
}