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

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

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

Scope: task

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

У метода есть версия REST 3.0 с тем же именем — tasks.task.list. Ее вызывают по адресу с /rest/api/. Она возвращает задачи в result.items, а не в result.tasks, а страницы выбирает параметром pagination вместо start.

Метод tasks.task.list получает список задач с постраничной навигацией. Он заменяет устаревший метод task.items.getlist.

Какие задачи попадут в список, зависит от прав пользователя:

  • администратор — все задачи
  • руководитель — задачи своих сотрудников
  • остальные — только доступные им задачи

Параметры метода

Обязательные параметры отмечены *

Все параметры метода необязательные.

Название
тип

Описание

order
object

Объект для сортировки списка задач в формате {"field_1": "value_1", ... "field_N": "value_N"}.

Направление сортировки может принимать значения:

  • asc — по возрастанию
  • desc — по убыванию

По умолчанию — по убыванию ID.

Поле для сортировки может принимать значения:

  • ID — идентификатор задачи
  • TITLE — название задачи
  • TIME_SPENT_IN_LOGS — затраченное время, зафиксированное в истории изменений
  • DATE_START — дата старта задачи
  • CREATED_DATE — дата создания задачи
  • CHANGED_DATE — дата последнего изменения задачи
  • CLOSED_DATE — дата завершения задачи
  • ACTIVITY_DATE — дата последней активности
  • START_DATE_PLAN — плановая дата начала выполнения задачи
  • END_DATE_PLAN — плановая дата завершения выполнения задачи
  • DEADLINE — крайний срок выполнения задачи
  • REAL_STATUS — статус задачи
  • STATUS_COMPLETE — флаг завершенности задачи
  • PRIORITY — приоритет задачи
  • MARK — оценка за выполнение задачи
  • CREATED_BY_LAST_NAME — фамилия постановщика задачи
  • RESPONSIBLE_LAST_NAME — фамилия исполнителя задачи
  • GROUP_ID — идентификатор рабочей группы
  • TIME_ESTIMATE — время, выделенное на задачу
  • ALLOW_CHANGE_DEADLINE — флаг, разрешающий исполнителю менять крайний срок
  • ALLOW_TIME_TRACKING — флаг, включающий учет затраченного времени по задаче
  • MATCH_WORK_TIME — флаг, указывающий на необходимость пропускать выходные дни
  • FAVORITE — флаг, указывающий, что задача добавлена в избранное
  • SORTING — индекс сортировки
  • IS_PINNED — признак «закреплено»
  • IS_PINNED_IN_GROUP — признак «закреплена в группе»

filter
object

Объект для фильтрации списка задач в формате {"field_1": "value_1", ... "field_N": "value_N"}. Фильтруемое поле может принимать значения:

  • ID — идентификатор задачи
  • PARENT_ID — идентификатор родительской задачи
  • GROUP_ID — идентификатор рабочей группы
  • CREATED_BY — постановщик
  • STATUS_CHANGED_BY — пользователь, последним изменивший статус задачи
  • PRIORITY — приоритет
  • FORUM_TOPIC_ID — идентификатор темы форума
  • RESPONSIBLE_ID — исполнитель
  • TITLE — название задачи (можно искать по шаблону [%_])
  • TAG — тег задачи
  • REAL_STATUS — статус задачи. Соответствует полю status в ответе.
    • 2 — ждет выполнения
    • 3 — выполняется
    • 4 — ожидает контроля
    • 5 — завершена
    • 6 — отложена
  • STATUS — статус для сортировки. Соответствует полю subStatus в ответе. Аналогичен REAL_STATUS, но имеет три дополнительных мета-статуса:
    • -3 — задача почти просрочена
    • -2 — не просмотренная задача
    • -1 — просроченная задача
  • MARK — оценка
  • SITE_ID — идентификатор сайта
  • ADD_IN_REPORT — задача в отчете
  • DATE_START — дата начала выполнения
  • DEADLINE — крайний срок
  • CREATED_DATE — дата создания
  • CLOSED_DATE — дата завершения
  • CHANGED_DATE — дата последнего изменения
  • ACCOMPLICE — идентификатор соисполнителя
  • AUDITOR — идентификатор наблюдателя
  • DEPENDS_ON — идентификатор предыдущей задачи
  • ONLY_ROOT_TASKS — только корневые задачи и подзадачи без доступа к родителю
  • STAGE_ID — стадия
  • SPRINT_ID — идентификатор спринта
  • BACKLOG_ID — идентификатор бэклога
  • UF_CRM_TASK — привязка к элементам CRM

Чтобы получить задачи из Избранного, передайте в фильтре "FAVORITE": "Y". Тот же список вернет "::SUBFILTER-PARAMS": {"FAVORITE": "Y"}.

Перед названием фильтруемого поля можно указать тип фильтрации:

  • ! — не равно
  • < — меньше
  • <= — меньше либо равно
  • > — больше
  • >= — больше либо равно

По умолчанию записи не фильтруются

select
array

Массив содержит список полей, которые необходимо выбрать.

По умолчанию система возвращает только те поля, которые хранятся в записи — без дополнительных данных, рассчитываемых на лету.

Важно

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

params
object

Группы полей, которые метод добавит к каждой задаче: результат, затраченное время, описание для мобильного приложения (подробное описание).

По умолчанию эти поля не возвращаются

start
integer

Сколько записей пропустить от начала списка. На странице не более 50 записей.

Чтобы получить вторую страницу, передайте 50, третью — 100. Для страницы N значение считают по формуле start = (N - 1) * 50.

По умолчанию — 0, первая страница

Параметр params

Каждый ключ добавляет в ответ свою группу полей. Поля придут при любом значении ключа, даже при false или "N". Чтобы их не получать, не передавайте ключ.

Название
тип

Описание

WITH_RESULT_INFO
boolean

Добавляет поля о результате задачи: taskRequireResult, taskHasOpenResult, taskHasResult

WITH_TIMER_INFO
boolean

Добавляет поля о затраченном времени: timeElapsed, timerIsRunningForCurrentUser

WITH_PARSED_DESCRIPTION
boolean

Добавляет поле parsedDescription — описание задачи, подготовленное для мобильного приложения

Подробно поля описаны в разделе Дополнительные поля задачи.

Примеры кода

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"order":{"DEADLINE":"asc","PRIORITY":"desc"},"filter":{"!STATUS":6,">=DEADLINE":"'"$(date +%Y-%m-%d)"'","RESPONSIBLE_ID":547,"::SUBFILTER-PARAMS":{"FAVORITE":"Y"}},"select":["ID","TITLE","DESCRIPTION","STATUS","subStatus","DEADLINE","CREATED_DATE","RESPONSIBLE_ID","ACCOMPLICES","AUDITORS","TAGS","COUNTERS","PRIORITY","MARK"],"params":{"WITH_TIMER_INFO":true,"WITH_RESULT_INFO":true,"WITH_PARSED_DESCRIPTION":true}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.list
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"order":{"DEADLINE":"asc","PRIORITY":"desc"},"filter":{"!STATUS":6,">=DEADLINE":"'"$(date +%Y-%m-%d)"'","RESPONSIBLE_ID":547,"::SUBFILTER-PARAMS":{"FAVORITE":"Y"}},"select":["ID","TITLE","DESCRIPTION","STATUS","subStatus","DEADLINE","CREATED_DATE","RESPONSIBLE_ID","ACCOMPLICES","AUDITORS","TAGS","COUNTERS","PRIORITY","MARK"],"params":{"WITH_TIMER_INFO":true,"WITH_RESULT_INFO":true,"WITH_PARSED_DESCRIPTION":true},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/tasks.task.list
// 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, ISODate } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

// Shape of a single task in result.tasks. Only the fields read below are typed here;
// the request selects more — add them to this type as you start using them.
type TaskListItem = {
  id: string
  title: string
  status: string
  deadline: ISODate | null
  responsibleId: string
}

try {
  // tasks.task.list 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<{ tasks: TaskListItem[] }>({
    method: 'tasks.task.list',
    params: {
      // Sorting: nearest deadline first, then higher priority
      order: { DEADLINE: 'asc', PRIORITY: 'desc' },
      filter: {
        '!STATUS': 6, // exclude deferred tasks
        '>=DEADLINE': new Date().toISOString().split('T')[0], // not overdue (UTC date; adjust to the portal time zone if needed)
        RESPONSIBLE_ID: 547, // tasks of a specific responsible person
        '::SUBFILTER-PARAMS': { FAVORITE: 'Y' } // favorites only
      },
      // Request only the fields you need
      select: [
        'ID', 'TITLE', 'DESCRIPTION', 'STATUS', 'subStatus',
        'DEADLINE', 'CREATED_DATE', 'RESPONSIBLE_ID',
        'ACCOMPLICES', 'AUDITORS', 'TAGS', 'COUNTERS',
        'PRIORITY', 'MARK'
      ],
      // Extra computed data
      params: {
        WITH_TIMER_INFO: true,
        WITH_RESULT_INFO: true,
        WITH_PARSED_DESCRIPTION: true
      },
      // Page offset (not the page number): the page size is fixed at 50, so the
      // Nth page is start = (N - 1) * 50.
      start: 0
    },
    requestId: Text.getUuidRfc4122() // optional unique tracking id for this request
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const tasks = response.getData()!.result.tasks
    // getTotal() is deprecated (removed in SDK 2.0); for the full match count fetch
    // everything via a list helper (see above) and read its length.
    console.info(`Loaded ${tasks.length} tasks (one page)`)
    for (const task of tasks) {
      console.info(`#${task.id}: ${task.title}`)
    }
  }
} 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 listTasks() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      // tasks.task.list 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: 'tasks.task.list',
        params: {
          // Sorting: nearest deadline first, then higher priority
          order: { DEADLINE: 'asc', PRIORITY: 'desc' },
          filter: {
            '!STATUS': 6, // exclude deferred tasks
            '>=DEADLINE': new Date().toISOString().split('T')[0], // not overdue (UTC date; adjust to the portal time zone if needed)
            RESPONSIBLE_ID: 547, // tasks of a specific responsible person
            '::SUBFILTER-PARAMS': { FAVORITE: 'Y' } // favorites only
          },
          // Request only the fields you need
          select: [
            'ID', 'TITLE', 'DESCRIPTION', 'STATUS', 'subStatus',
            'DEADLINE', 'CREATED_DATE', 'RESPONSIBLE_ID',
            'ACCOMPLICES', 'AUDITORS', 'TAGS', 'COUNTERS',
            'PRIORITY', 'MARK'
          ],
          // Extra computed data
          params: {
            WITH_TIMER_INFO: true,
            WITH_RESULT_INFO: true,
            WITH_PARSED_DESCRIPTION: true
          },
          // Page offset (not the page number): the page size is fixed at 50, so the
          // Nth page is start = (N - 1) * 50.
          start: 0
        },
        requestId: B24Js.Text.getUuidRfc4122() // optional unique tracking id for this request
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const tasks = response.getData().result.tasks
      // getTotal() is deprecated (removed in SDK 2.0); for the full match count fetch
      // everything via a list helper (see above) and read its length.
      console.info(`Loaded ${tasks.length} tasks (one page)`)
      for (const task of tasks) {
        console.info(`#${task.id}: ${task.title}`)
      }
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', listTasks)
</script>
from datetime import date

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

order = {
    "DEADLINE": "asc",
    "PRIORITY": "desc",
}
filter = {
    "!STATUS": 6,
    ">=DEADLINE": date.today().isoformat(),
    "RESPONSIBLE_ID": 547,
    "::SUBFILTER-PARAMS": {
        "FAVORITE": "Y",
    },
}
select = [
    "ID",
    "TITLE",
    "DESCRIPTION",
    "STATUS",
    "subStatus",
    "DEADLINE",
    "CREATED_DATE",
    "RESPONSIBLE_ID",
    "ACCOMPLICES",
    "AUDITORS",
    "TAGS",
    "COUNTERS",
    "PRIORITY",
    "MARK",
]
params = {
    "WITH_TIMER_INFO": True,
    "WITH_RESULT_INFO": True,
    "WITH_PARSED_DESCRIPTION": True,
}

try:
    bitrix_response = client.tasks.task.list(
        order=order,
        filter=filter,
        select=select,
        params=params,
        start=0,
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")
try {
    $response = $b24Service
        ->core
        ->call(
            'tasks.task.list',
            [
                'order' => [
                    'DEADLINE' => 'asc',
                    'PRIORITY' => 'desc'
                ],
                'filter' => [
                    '!STATUS' => 6,
                    '>=DEADLINE' => date('Y-m-d'),
                    'RESPONSIBLE_ID' => 547,
                    '::SUBFILTER-PARAMS' => ['FAVORITE' => 'Y']
                ],
                'select' => [
                    'ID', 'TITLE', 'DESCRIPTION', 'STATUS', 'subStatus',
                    'DEADLINE', 'CREATED_DATE', 'RESPONSIBLE_ID',
                    'ACCOMPLICES', 'AUDITORS', 'TAGS', 'COUNTERS',
                    'PRIORITY', 'MARK'
                ],
                'params' => [
                    'WITH_TIMER_INFO' => true,
                    'WITH_RESULT_INFO' => true,
                    'WITH_PARSED_DESCRIPTION' => true,
                ],
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    echo 'Success: ' . print_r($result, true);
    processData($result);

} catch (Throwable $e) {
    error_log($e->getMessage());
    echo 'Error fetching tasks: ' . $e->getMessage();
}
BX24.callMethod(
    'tasks.task.list',
    {
        // Сортировка
        order: {
            'DEADLINE': 'asc',
            'PRIORITY': 'desc'
        },
        // Фильтрация
        filter: {
            '!STATUS': 6, // Исключить отложенные
            '>=DEADLINE': new Date().toISOString().split('T')[0], // Не просроченные
            'RESPONSIBLE_ID': 547, // Задачи конкретного исполнителя
            '::SUBFILTER-PARAMS': { 'FAVORITE': 'Y' } // Задачи из избранного
        },
        // Поля для выборки
        select: [
            'ID',
            'TITLE',
            'DESCRIPTION',
            'STATUS',
            'subStatus',
            'DEADLINE',
            'CREATED_DATE',
            'RESPONSIBLE_ID',
            'ACCOMPLICES',
            'AUDITORS',
            'TAGS',
            'COUNTERS',
            'PRIORITY',
            'MARK'
        ],
        // Дополнительные параметры
        params: {
            'WITH_TIMER_INFO': true,
            'WITH_RESULT_INFO': true,
            'WITH_PARSED_DESCRIPTION': true,
        },
    },
    function(result){
        console.info(result.data());
        console.log(result);
    }
);
require_once('crest.php');

$result = CRest::call(
    'tasks.task.list',
    [
        'order' => [
            'DEADLINE' => 'asc',
            'PRIORITY' => 'desc'
        ],
        'filter' => [
            '!STATUS' => 6,
            '>=DEADLINE' => date('Y-m-d'),
            'RESPONSIBLE_ID' => 547,
            '::SUBFILTER-PARAMS' => ['FAVORITE' => 'Y']
        ],
        'select' => [
            'ID', 'TITLE', 'DESCRIPTION', 'STATUS', 'subStatus',
            'DEADLINE', 'CREATED_DATE', 'RESPONSIBLE_ID',
            'ACCOMPLICES', 'AUDITORS', 'TAGS', 'COUNTERS',
            'PRIORITY', 'MARK'
        ],
        'params' => [
            'WITH_TIMER_INFO' => true,
            'WITH_RESULT_INFO' => true,
            'WITH_PARSED_DESCRIPTION' => true,
        ],
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "tasks.task.list", b24.Params{
	"order": b24.Params{
		"DEADLINE": "asc",
		"PRIORITY": "desc",
	},
	"filter": b24.Params{
		"!STATUS":        6,
		">=DEADLINE":     time.Now().Format("2006-01-02"),
		"RESPONSIBLE_ID": 547,
		"::SUBFILTER-PARAMS": b24.Params{
			"FAVORITE": "Y",
		},
	},
	"select": []string{"ID", "TITLE", "DESCRIPTION", "STATUS", "subStatus", "DEADLINE", "CREATED_DATE", "RESPONSIBLE_ID", "ACCOMPLICES", "AUDITORS", "TAGS", "COUNTERS", "PRIORITY", "MARK"},
	"params": b24.Params{
		"WITH_TIMER_INFO":         true,
		"WITH_RESULT_INFO":        true,
		"WITH_PARSED_DESCRIPTION": true,
	},
}, b24.WithIdempotent())
if err != nil {
	return fmt.Errorf("tasks.task.list: %w", err)
}

// Метод заворачивает ответ в объект с ключом "tasks".
raw, ok := b24.Unwrap(res.Result, "tasks")
if !ok {
	return fmt.Errorf("в ответе нет ключа tasks")
}

var items []struct {
	ID            b24.ID `json:"id"`
	Title         string `json:"title"`
	Description   string `json:"description"`
	Deadline      string `json:"deadline"`
	CreatedDate   string `json:"createdDate"`
	ResponsibleID b24.ID `json:"responsibleId"`
}
if err := json.Unmarshal(raw, &items); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
for _, it := range items {
	fmt.Println(it.ID)
}

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "tasks": [
            {
                "id": "8017",
                "title": "Пример задачи",
                "description": "Описание задачи с [B]форматированием[/B]",
                "deadline": "2025-10-24T19:00:00+03:00",
                "createdDate": "2025-06-04T16:15:55+03:00",
                "responsibleId": "547",
                "priority": "2",
                "mark": null,
                "descriptionInBbcode": "Y",
                "lengthDeadline": "1",
                "status": "2",
                "auditors": [
                    "13",
                    "103"
                ],
                "accomplices": [],
                "group": [],
                "responsible": {
                    "id": "547",
                    "name": "Мария",
                    "link": "/company/personal/user/547/",
                    "icon": "/bitrix/images/tasks/default_avatar.png",
                    "workPosition": "Тестировщик"
                },
                "accomplicesData": [],
                "auditorsData": {
                    "13": {
                        "id": "13",
                        "name": "Иван Иванов",
                        "link": "/company/personal/user/13/",
                        "icon": "https://mysite.ru/b17053/resize_cache/209/c0120a8d7c10d63c83e32398d1ec4d9e/main/c8dd225a1c6ea0a25722d01644b90fe4/8b.jpg",
                        "workPosition": "Системный администратор"
                    },
                    "103": {
                        "id": "103",
                        "name": "Светлана Иванова",
                        "link": "/company/personal/user/103/",
                        "icon": "https://mysite.ru/b17053/resize_cache/8644/c0120a8d7c10d63c83e32398d1ec4d9e/main/45f/45fff10d17d398a5583184c8350cd197/buh.jpg",
                        "workPosition": "Бухгалтер"
                    }
                },
                "taskRequireResult": "Y",
                "taskHasOpenResult": "N",
                "taskHasResult": "Y",
                "timeElapsed": null,
                "timerIsRunningForCurrentUser": "N",
                "parsedDescription": "Описание задачи с [B]форматированием[/B]",
                "counter": {
                    "counters": {
                        "expired": 0,
                        "newComments": 0,
                        "projectExpired": 0,
                        "projectNewComments": 0,
                        "mutedExpired": 0,
                        "mutedNewComments": 0
                    },
                    "color": "gray",
                    "value": 0
                },
                "tags": {
                    "35": {
                        "id": 35,
                        "title": "арпар"
                    }
                },
                "subStatus": "2"
            }
        ]
    },
    "total": 1,
    "time": {
        "start": 1761054322,
        "finish": 1761054322.348041,
        "duration": 0.3480410575866699,
        "processing": 0,
        "date_start": "2025-10-21T16:45:22+03:00",
        "date_finish": "2025-10-21T16:45:22+03:00",
        "operating_reset_at": 1761054922,
        "operating": 0
    }
}

Возвращаемые данные

Название
тип

Описание

result
object

Объект с данными ответа

result.tasks
object[]

Массив задач. Каждый элемент — объект с полями задачи и дополнительными полями.

Какие поля придут, зависит от select, params и сортировки order

total
integer

Общее количество найденных записей

time
time

Информация о времени выполнения запроса

Дополнительные поля задачи

У каждого поля свое условие, оно указано в описании: нужное поле в select, ключ в params или сортировка по DEADLINE.

Название
тип

Описание

group
object

Группа задачи: id, name, opened — открытая ли группа, membersCount — число участников, image — адрес картинки, additionalData.

Приходит пустым массивом [], если задача не в группе или в select нет GROUP_ID

creator
object

Данные постановщика. Приходит, если в select есть CREATED_BY

responsible
object

Данные исполнителя. Приходит, если в select есть RESPONSIBLE_ID

accomplicesData
object

Данные соисполнителей. Ключ — идентификатор пользователя, значение — данные пользователя. Если соисполнителей нет — пустой массив []. Приходит, если в select есть ACCOMPLICES

auditorsData
object

Данные наблюдателей в том же формате, что accomplicesData. Приходит, если в select есть AUDITORS

subStatus
string

Статус с учетом просрочки и просмотра, например -1 — задача просрочена. Значения — как у фильтра STATUS. Приходит, если в select есть STATUS. Обычный статус приходит в поле status

lengthDeadline
string

1 — у задачи есть крайний срок, 0 — нет. Приходит, если список отсортирован по DEADLINE по возрастанию

counter
object

Счетчики задачи для текущего пользователя:

  • counters — счетчики просрочки и новых комментариев: expired и newComments, для задач групп — projectExpired и projectNewComments, для задач с выключенными уведомлениями — mutedExpired и mutedNewComments
  • value — сумма всех счетчиков
  • color — цвет счетчика: danger — задача просрочена, success — есть новые комментарии, gray — остальные случаи

Приходит, если в select есть COUNTERS

tags
object

Теги задачи. Ключ — идентификатор тега, значение — объект с полями id и title. Приходит, если в select есть TAGS

taskRequireResult
string

Y — постановщик требует отчет о результате, N — не требует. Приходит с ключом WITH_RESULT_INFO

taskHasResult
string

Y — у задачи есть результат, N — нет. Приходит с ключом WITH_RESULT_INFO

taskHasOpenResult
string

Y — последний результат задачи открыт, N — нет. Приходит с ключом WITH_RESULT_INFO

timeElapsed
string

Затраченное время в секундах. Если у текущего пользователя идет таймер по задаче, к времени из истории добавлено время таймера. Приходит с ключом WITH_TIMER_INFO. Чтобы получить значение, а не null, добавьте в select поле TIME_SPENT_IN_LOGS

timerIsRunningForCurrentUser
string

Y — у текущего пользователя идет таймер по задаче, N — нет. Приходит с ключом WITH_TIMER_INFO

parsedDescription
string

Описание задачи в BB-коде, подготовленное для мобильного приложения: таблицы, видео и файлы заменены ссылками, разметка списков и выравнивания убрана. Приходит с ключом WITH_PARSED_DESCRIPTION, если в Битрикс24 установлен модуль мобильных задач. Чтобы получить текст, а не пустую строку, добавьте в select поле DESCRIPTION

Обработка ошибок

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Неверный ключ сортировки"
}

Название
тип

Описание

error
string

Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только error_description

error_description
string

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

Возможные коды ошибок

Статус

Код

Описание

Значение

400

0

Неверный ключ сортировки

В параметре order указано поле задачи, по которому нельзя сортировать, или несуществующее поле

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус

Код
Текст ошибки

Описание

500

INTERNAL_SERVER_ERROR
Internal server error

Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24

500

ERROR_UNEXPECTED_ANSWER
Server returned an unexpected response

Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24

503

QUERY_LIMIT_EXCEEDED
Too many requests

Превышен лимит на интенсивность запросов

429

OPERATION_TIME_LIMIT
Method is blocked due to operation time limit

Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит

401

NO_AUTH_FOUND
Wrong authorization data

В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука

401

INVALID_REQUEST
Https required

Методы вызываются только по протоколу HTTPS

401

OVERLOAD_LIMIT
REST API is blocked due to overload

REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24

401

ACCESS_DENIED
REST is available only on commercial plans

REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — REST is available only by subscription

401

INVALID_CREDENTIALS
Invalid request credentials

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

404

ERROR_METHOD_NOT_FOUND
Method not found!

Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа

401

insufficient_scope
The request requires higher privileges than provided by the webhook token

Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на provided by the access token

401

expired_token
The access token provided has expired

Срок действия access-токена истек

401

user_access_error
The user does not have access to the application

Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям

403

PORTAL_DELETED
Portal was deleted

Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение