Подключиться
Yandex Tracker

Узнать количество задач

Статья создана

Запрос позволяет узнать количество задач, удовлетворяющих условиям вашего запроса.

Формат запроса

Перед выполнением запроса получите доступ к API.

Для получения числа задач, удовлетворяющих определенным критериям, используйте HTTP-запрос с методом POST. Критерии для поиска передаются в теле запроса в формате JSON:

POST /v2/issues/_count
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор организации>

{
"filter": {
    "<имя поля>": "<значение в поле>"
  },
  "query": "фильтр на языке запросов"
}
Заголовки

  • Host

    Адрес узла, предоставляющего API:

    https://api.tracker.yandex.net

  • Authorization

    OAuth-токен в формате OAuth <значение токена>, например:

    OAuth 0c4181a7c2cf4521964a72ff57a34a07

  • X-Org-ID

    Идентификатор организации.

Параметры тела запроса

Дополнительные параметры

Параметр Описание Формат
filter Параметры фильтрации задач. В параметре можно указать название любого поля и значение, по которому будет производиться фильтрация. Объект
query Фильтр на языке запросов. Строка

Запрос количества задач с указанием дополнительных параметров фильтрации:

  • Используется HTTP-метод POST.
  • Ответ должен содержать только количество задач из очереди JUNE, в которых не указан исполнитель.
POST /v2/issues/_count HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор организации>

{
  "filter": {
    "queue": "JUNE",
    "assignee": "empty()"
  }
}

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

В ответе содержится число задач, удовлетворяющих условиям вашего запроса.

5221186

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Tracker — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
В этой статье: