метод REST scope: task Устаревший

task.items.getlist

Получить список задач

Устаревший метод. Развитие метода остановлено. Используйте tasks.task.list.

Кто может выполнять: любой пользователь

Описание

Метод возвращает массив задач, каждая из которых содержит массив полей (аналогичен массиву, возвращаемому task.item.getdata).

Параметры

ORDER object необязательный

Массив вида {'поле_сортировки': 'направление сортировки' [, ...]} для сортировки результата. Поле для сортировки может принимать значения:
- TITLE — название задачи
- DATE_START — дата старта
- DEADLINE — крайний срок
- STATUS — статус
- PRIORITY — приоритет
- MARK — оценка
- CREATED_BY — постановщик
- RESPONSIBLE_ID — исполнитель
- GROUP_ID — рабочая группа

Направление сортировки может принимать значения:
- asc — по возрастанию
- desc — по убыванию

Необязательный параметр. По умолчанию фильтруется по убыванию идентификатора задачи.

Допускается сортировка по пользовательским полям

FILTER object необязательный

Массив вида {'фильтруемое_поле': "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения:
- ID — идентификатор задачи
- PARENT_ID — идентификатор родительской задачи
- GROUP_ID — идентификатор рабочей группы
- CREATED_BY — постановщик
- STATUS_CHANGED_BY — пользователь, последним изменивший статус задачи
- PRIORITY — приоритет
- FORUM_TOPIC_ID — идентификатор темы форума
- RESPONSIBLE_ID — исполнитель
- TITLE — название задачи (можно искать по шаблону [%_])
- TAG — тег
- REAL_STATUS — статус задачи с возможными значениями:
- STATE_NEW = 1
- STATE_PENDING = 2
- STATE_IN_PROGRESS = 3
- STATE_SUPPOSEDLY_COMPLETED = 4
- STATE_COMPLETED = 5
- STATE_DEFERRED = 6
- STATE_DECLINED = 7
- STATUS — статус для сортировки. Аналогичен REAL_STATUS, но также включает мета-статусы:
- -2 — непросмотренная задача
- -1 — просроченная задача
- MARK — оценка
- XML_ID — внешний код
- SITE_ID — идентификатор сайта
- ADD_IN_REPORT — задача в отчете (Y|N)
- DATE_START — дата начала выполнения
- DEADLINE — крайний срок
- CREATED_DATE — дата создания
- CLOSED_DATE — дата завершения
- CHANGED_DATE — дата последнего изменения
- ACCOMPLICE — идентификатор соисполнителя
- AUDITOR — идентификатор аудитора
- DEPENDS_ON — идентификатор предыдущей задачи
- ONLY_ROOT_TASKS — только задачи, которые не являются подзадачами (корневые задачи), а также подзадачи родительской задачи, к которой текущий пользователь доступа не имеет (Y|N)
- SUBORDINATE_TASKS — задачи текущего пользователя и его подчиненных (Y|N)
- OVERDUED — были просрочены (Y|N)
- DEPARTMENT_ID — идентификатор отдела

Перед названием фильтруемого поля можно указать тип фильтрации:
- ! — не равно
- < — меньше
- <= — меньше либо равно
- > — больше
- >= — больше либо равно

Значения фильтра — одиночное значение или массив.

Необязательный параметр. По умолчанию записи не фильтруются

TASKDATA array необязательный

Массив возвращаемых полей задачи

NAV_PARAMS array необязательный

Постраничная навигация. Доступна опция iNumPage — номер страницы

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.items.getlist

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.