Получить список задач task.items.getlist

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: task

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

DEPRECATED

Развитие метода остановлено. Используйте 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 — номер страницы

Соблюдение порядка следования параметров в запросе обязательно. При его нарушении запрос будет выполнен с ошибками.

Примеры кода

Как использовать примеры в документации

Получить список всех задач (по умолчанию сработает ограничение — постраничная навигация по 50 элементов).

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
        
curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{}' \
        https://**put_your_bitrix24_address**/rest/task.items.getlist?auth=**put_access_token_here**
        
// This snippet is an ES module: top-level await requires type="module" or a bundler.
        // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
        import { Text } from '@bitrix24/b24jssdk'
        import type { B24Frame } from '@bitrix24/b24jssdk'
        
        declare const $b24: B24Frame
        
        // TODO: verify API version — no response shape defined on this page
        type TaskItem = Record<string, unknown>
        
        try {
          // task.items.getlist returns a single page (max 50 records). For the whole result set
          // use a list helper: $b24.actions.v2.callList.make() returns every record as one
          // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
          // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
          // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
          const response = await $b24.actions.v2.call.make<TaskItem[]>({
            method: 'task.items.getlist',
            params: {},
            requestId: Text.getUuidRfc4122()
          })
        
          // The payload is available only on a successful response
          if (!response.isSuccess) {
            console.error(response.getErrorMessages().join('; '))
          } else {
            const result = response.getData()!.result
            console.info('Tasks retrieved:', result.length)
          }
        } catch (error) {
          // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
          console.error(error)
        }
        
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
        <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
        <script>
          async function getTaskItemsList() {
            try {
              // Initialize the SDK inside a Bitrix24 frame
              const $b24 = await B24Js.initializeB24Frame()
        
              // task.items.getlist returns a single page (max 50 records). For the whole result set
              // use a list helper: $b24.actions.v2.callList.make() returns every record as one
              // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
              // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
              // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
              const response = await $b24.actions.v2.call.make({
                method: 'task.items.getlist',
                params: {},
                requestId: B24Js.Text.getUuidRfc4122()
              })
        
              // The payload is available only on a successful response
              if (!response.isSuccess) {
                console.error(response.getErrorMessages().join('; '))
                return
              }
        
              const result = response.getData().result
              console.info('Tasks retrieved:', result.length)
            } catch (error) {
              // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
              console.error(error)
            }
          }
        
          document.addEventListener('DOMContentLoaded', getTaskItemsList)
        </script>
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'task.items.getlist',
                    []
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting task items list: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'task.items.getlist',
            [],
            function(result)
            {
                console.info(result.data());
                console.log(result);
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'task.items.getlist',
            []
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';
        
// client и ctx уже созданы — см. раздел «SDK для Go»
        res, err := client.Core().Call(ctx, "task.items.getlist", nil, b24.WithIdempotent())
        if err != nil {
        	return fmt.Errorf("task.items.getlist: %w", err)
        }
        
        // Ответ приходит как json.RawMessage — разберите его
        // в структуру под форму ответа, показанную ниже на этой странице.
        fmt.Printf("%s\n", res.Result)

Получить список задач с идентификаторами 1, 2, 3, 4, 5, 6, причем выбрать только поля ID и TITLE. Режим постраничной навигации — по 2 элемента на странице, 2-я страница. Сортировка по ID — по убыванию.

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"order":{"ID":"desc"},"filter":{"ID":[1,2,3,4,5,6]},"select":["ID","TITLE"],"NAV_PARAMS":{"iNumPage":2}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.items.getlist
        
curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"order":{"ID":"desc"},"filter":{"ID":[1,2,3,4,5,6]},"select":["ID","TITLE"],"NAV_PARAMS":{"iNumPage":2},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/task.items.getlist
        
// This snippet is an ES module: top-level await requires type="module" or a bundler.
        // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
        import { Text } from '@bitrix24/b24jssdk'
        import type { B24Frame } from '@bitrix24/b24jssdk'
        
        declare const $b24: B24Frame
        
        // TODO: verify API version — no response shape defined on this page
        type TaskItem = Record<string, unknown>
        
        try {
          // task.items.getlist returns a single page (max 50 records). For the whole result set
          // use a list helper: $b24.actions.v2.callList.make() returns every record as one
          // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
          // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
          // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
          const response = await $b24.actions.v2.call.make<TaskItem[]>({
            method: 'task.items.getlist',
            params: {
              order: { ID: 'desc' },               // sort by ID descending
              filter: { ID: [1, 2, 3, 4, 5, 6] },  // filter by IDs
              select: ['ID', 'TITLE'],              // return only these fields
              NAV_PARAMS: { iNumPage: 2 },          // page 2
            },
            requestId: Text.getUuidRfc4122()
          })
        
          // The payload is available only on a successful response
          if (!response.isSuccess) {
            console.error(response.getErrorMessages().join('; '))
          } else {
            const result = response.getData()!.result
            console.info('Tasks on page:', result.length)
          }
        } catch (error) {
          // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
          console.error(error)
        }
        
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
        <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
        <script>
          async function getTaskItemsListFiltered() {
            try {
              // Initialize the SDK inside a Bitrix24 frame
              const $b24 = await B24Js.initializeB24Frame()
        
              // task.items.getlist returns a single page (max 50 records). For the whole result set
              // use a list helper: $b24.actions.v2.callList.make() returns every record as one
              // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
              // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
              // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
              const response = await $b24.actions.v2.call.make({
                method: 'task.items.getlist',
                params: {
                  order: { ID: 'desc' },               // sort by ID descending
                  filter: { ID: [1, 2, 3, 4, 5, 6] },  // filter by IDs
                  select: ['ID', 'TITLE'],              // return only these fields
                  NAV_PARAMS: { iNumPage: 2 },          // page 2
                },
                requestId: B24Js.Text.getUuidRfc4122()
              })
        
              // The payload is available only on a successful response
              if (!response.isSuccess) {
                console.error(response.getErrorMessages().join('; '))
                return
              }
        
              const result = response.getData().result
              console.info('Tasks on page:', result.length)
            } catch (error) {
              // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
              console.error(error)
            }
          }
        
          document.addEventListener('DOMContentLoaded', getTaskItemsListFiltered)
        </script>
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'task.items.getlist',
                    [
                        ['ID' => 'desc'], // Сортировка по ID — по убыванию.
                        ['ID' => [1, 2, 3, 4, 5, 6]], // Фильтр
                        ['ID', 'TITLE'], // Выбираемые поля
                        [
                            'NAV_PARAMS' => [ // постраничка
                                'iNumPage' => 2 // страница номер 2
                            ]
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting task items list: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'task.items.getlist',
            [
                {ID : 'desc'},        // Сортировка по ID — по убыванию.
                {ID: [1,2,3,4,5,6]},    // Фильтр
                ['ID', 'TITLE'],    // Выбираемые поля
                {
                    NAV_PARAMS: {        // постраничка
                        iNumPage : 2        // страница номер 2
                    }
                }
            ],
            function(result)
            {
                console.info(result.data());
                console.log(result);
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'task.items.getlist',
            [
                'order' => ['ID' => 'desc'],
                'filter' => ['ID' => [1, 2, 3, 4, 5, 6]],
                'select' => ['ID', 'TITLE'],
                'NAV_PARAMS' => ['iNumPage' => 2]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

В целях ограничения нагрузки на постраничную навигацию наложено ограничение в 50 задач.

Предыдущая
Удалить привязку файла к задаче
Следующая
Добавить комментарий к задаче