Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Tracker
  • Начало работы
    • Подключить Tracker
    • Настроить Tracker
    • Как работать в Tracker
      • Войти в Tracker
      • Начальная страница
      • Мои задачи
      • Как работать с задачей
      • Избранные задачи, доски, дашборды
      • Персональные настройки
    • Мигрировать в Tracker
    • Отключить платные услуги
  • Сценарии использования
    • Настроить Tracker для команды разработки
      • Обзор
      • Создать очередь для команды разработки
      • Структурировать задачи
      • Использовать гибкие методологии (Agile)
      • Настроить шаблоны задач
      • Подключить репозиторий
      • Автоматизировать рутинные действия
      • Интегрировать Tracker с другими системами
    • Настроить Tracker для службы поддержки
      • Обзор
      • Создать очередь для службы поддержки
      • Принимать обращения через форму
      • Настроить многоуровневую структуру поддержки
      • Группировать обращения по темам
      • Отслеживать время обработки обращений
      • Собирать статистику по обращениям
      • Настроить интеграцию со сторонними системами
  • Концепции
    • Обзор сервиса
    • Основные понятия
  • Настроить очередь
    • Обзор
    • Создать очередь
    • Шаблоны очередей
    • Просмотреть задачи очереди
    • Изменить основные параметры очереди
    • Настроить типы и статусы задач
      • Обзор
      • Настроить типы задач
      • Создать воркфлоу
      • Настроить статусы
      • Настроить переходы
      • Добавить типы задач, статусы, резолюции
        • Создать тип задачи
        • Создать статус
        • Создать резолюцию
    • Локальные поля задач
    • Добавить команду очереди
    • Настроить доступ к очереди
    • Расширенные возможности очереди
    • Посмотреть историю изменений очереди
    • Удалить очередь
  • Работать с задачами
    • Создать задачу
      • Обзор
      • Клонировать задачу
    • Редактировать задачу
      • Обзор
      • Добавить комментарии к задаче
      • Форматировать текст в задаче
      • Изменить связи задачи
      • Выполнить макрос
      • Изменить несколько задач
    • Создать чеклист
    • Настроить напоминание о задаче
    • Отметить затраченное время
    • Добавить поле задачи
    • Посмотреть историю изменений задачи
    • Проголосовать за задачу
    • Получить доступ к задаче
    • Удалить задачу
  • Структурировать задачи
    • Обзор
    • Связи между задачами
    • Проекты
    • Компоненты
    • Версии
  • Инструменты гибкой разработки
    • Обзор
    • Создать доску
    • Работать с доской
    • Изменить и удалить доску
    • Спринты
    • Эпики
    • Командная оценка задач
    • Диаграмма сгорания задач
  • Найти задачи
    • Обзор
    • Найти мои задачи
    • Найти задачи в очереди
    • Создать фильтр задач
    • Язык запросов
  • Уведомления и подписки
    • Обзор
    • Подписаться на уведомления
    • Получать отчет об изменениях
    • Подписать пользователей на изменения очереди
    • Настройки уведомлений
      • Обзор
      • Уведомления о ваших задачах
      • Уведомления о ваших подписках
  • Статистика и дашборды
    • Дашборды
      • Обзор
      • Как создать дашборд
      • Виджеты
      • Как изменить дашборд
      • Общий доступ к дашбордам
      • Как сделать дашборд начальной страницей
    • Статистика очереди
    • Диаграмма Гантта
  • Автоматизация и шаблоны
    • Обзор
    • Триггеры
      • Обзор
      • Создать триггер
      • Задать условие срабатывания триггера
      • Настроить действие триггера
      • Изменить и удалить триггер
      • Примеры
    • Автодействия
      • Обзор
      • Автоматическое обновление задач
      • Создание задач по расписанию
      • Изменить и удалить автодействие
    • Макросы
    • Шаблоны
      • Обзор
      • Создать шаблон
      • Изменить шаблон
      • Удалить шаблон
      • Использовать общие шаблоны
  • Настроить SLA для задач
    • Обзор
    • Настроить правила
    • Графики работы
  • Интеграция с другими сервисами
    • Формы
    • Вики
    • Мессенджеры
      • Обзор
      • Slack
      • Telegram
  • Инструменты разработчика
    • Плагин для IDE
    • API
    • Python клиент
    • Подключить репозиторий
  • Правила тарификации
  • Справочник API
    • Обзор
    • Доступ к API
    • Задачи
      • Получить параметры задачи
      • Редактировать задачу
      • Создать задачу
      • Перенести задачу в другую очередь
      • Узнать количество задач
      • Найти задачи
      • Освободить ресурсы просмотра прокрутки
      • Получить приоритеты
      • Получить связи задачи
      • Связать задачи
      • Получить переходы
      • Выполнить переход в статус
      • Получить историю изменений задачи
    • Чеклисты
      • Создать чеклист или добавить в него пункты
      • Получить параметры чеклиста
      • Редактировать чеклист
      • Удалить чеклист
    • Проекты
      • Создать проект
      • Получить параметры проекта
      • Получить список всех проектов
      • Получить список очередей проекта
      • Изменить проект
      • Удалить проект
    • Комментарии
      • Добавить комментарий
      • Получить комментарии к задаче
      • Редактировать комментарий
      • Удалить комментарий
    • Макросы
      • Получить макросы очереди
      • Получить макрос
      • Создать макрос
      • Редактировать макрос
      • Удалить макрос
    • Прикрепленные файлы
      • Получить список прикрепленных файлов
      • Скачать файл
      • Скачать миниатюру
      • Прикрепить файл
      • Загрузить временный файл
      • Удалить файл
    • Очереди
      • Создать очередь
      • Получить параметры очереди
      • Получить список очередей
      • Получить версии очереди
      • Получить обязательные поля очереди
      • Удалить очередь
      • Восстановить очередь
      • Удалить тег из очереди
    • Доски задач
      • Получить параметры всех досок
      • Получить параметры доски
      • Создать доску
      • Редактировать доску
      • Удалить доску
      • Колонки
        • Получить параметры всех колонок
        • Получить параметры колонки
        • Создать колонку
        • Редактировать колонку
        • Удалить колонку
      • Спринты
        • Получить все спринты доски
        • Получить спринт
        • Создать спринт
    • Импорт
      • Импортировать задачу
      • Импортировать файлы
      • Импортировать комментарии
      • Импортировать связи
    • Пакетные операции
      • Массовый перенос задач в другую очередь
      • Массовое редактирование задач
      • Массовое изменение статуса задач
    • Учет времени
      • Добавить запись о затраченном времени
      • Редактировать запись о затраченном времени
      • Удалить запись о затраченном времени
      • Получить записи о затраченном времени
        • Получить все записи по задаче
        • Отобрать записи по параметрам
    • Поля задачи
      • Получить параметры поля задачи
      • Изменить название поля задачи
      • Изменить возможные значения поля задачи
      • Создать категорию поля задачи
      • Локальные поля
        • Создать локальное поле очереди
        • Получить локальные поля очереди
        • Получить информацию о локальном поле очереди
        • Редактировать локальное поле очереди
    • Получить информацию о текущем пользователе
    • Возможные коды ответа
  • Вопросы и ответы
  • Служба поддержки
  1. Справочник API
  2. Очереди
  3. Получить список очередей

Получить список очередей

  • Формат запроса
  • Формат ответа
  • Постраничное отображение результатов
  • Возможные коды ответа

Запрос позволяет получить список доступных очередей. Если количество очередей в ответе более 50, необходимо использовать механизм постраничного отображения.

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

Для поиска задач используйте HTTP-запрос с методом GET:

GET /v2/queues?
&expand=<дополнительные поля в ответе>
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>

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

  • expand (необязательный)

    Дополнительные поля, которые будут включены в ответ. Возможные значения:

    • projects — проекты очереди.
    • components — компоненты.
    • versions — версии.
    • types — типы задач.
    • team — список участников команды.
    • workflows — жизненные циклы.
  • perPage (необязательный)

    Количество очередей на странице ответа. Значение по умолчанию — 50. Дополнительные параметры показа ответа можно настроить с помощью механизма постраничного отображения.

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

  • Используется HTTP-метод GET.
GET /v2/queues HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>
Cache-Control: no-cache

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

[
  {
    "self": "https://api.tracker.yandex.net/v2/queues/TEST",
    "id": 3,
    "key": "TEST",
    "version": 5,
    "name": "Test",
    "description": "Очередь, заведённая в тестовых целях",
    "lead": {
           "self": "https://api.tracker.yandex.net/v2/users/1120000000016876",
           "id": "<id сотрудника>",
           "display": "<отображаемое имя сотрудника>"
    },
    "assignAuto": false,
    "defaultType": {
           "self": "https://api.tracker.yandex.net/v2/issuetypes/1",
           "id": "1",
           "key": "bug",
           "display": "Ошибка"
    },
    "defaultPriority": {
           "self": "https://api.tracker.yandex.net/v2/priorities/3",
           "id": "3",
           "key": "normal",
           "display": "Средний"
    },
    "teamUsers": [
           {
               "self": "https://api.tracker.yandex.net/v2/users/1120000000016876",
               "id": "<id сотрудника>",
               "display": "<отображаемое имя сотрудника>"
           },
           ...
    ],
    "issueTypes": [
           {
               "self": "https://api.tracker.yandex.net/v2/issuetypes/1",
               "id": "1",
               "key": "bug",
               "display": "Ошибка"
           },
           ...
    ],
    "versions": [
           {
               "self": "https://api.tracker.yandex.net/v2/versions/4",
               "id": "4",
               "display": "Куку"
        }
    ],
    "workflows": {
           "dev": [
               {
                    "self": "https://api.tracker.yandex.net/v2/issuetypes/1",
                    "id": "1",
                    "key": "bug",
                    "display": "Ошибка"
                },
                ...
           ]
    },
    "denyVoting": false,
    "issueTypesConfig": [
           {
               "issueType": {
                      "self": "https://api.tracker.yandex.net/v2/issuetypes/1",
                      "id": "1",
                      "key": "bug",
                      "display": "Ошибка"
            },
            "workflow": {
                      "self": "https://api.tracker.yandex.net/v2/workflows/dev",
                      "id": "dev",
                      "display": "dev"
            },
            "resolutions": [
                   {
                      "self": "https://api.tracker.yandex.net/v2/resolutions/2",
                      "id": "2",
                      "key": "wontFix",
                      "display": "Не будет исправлено"
                   },
                ...
            ]
        },
        ...
    ]
  },
  ...
]  

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

Параметр Описание Тип данных
self Ссылка на очередь. Строка.
id Идентификатор очереди. Строка.
key Ключ очереди. Строка.
version Версия очереди. Каждое изменение очереди увеличивает номер версии. Число.
name Название очереди. Строка.
description Текстовое описание очереди. Строка.
lead Блок с информацией о владельце очереди. Объект.
assignAuto Автоматически назначить исполнителя для новых задач очереди:

true— назначить.

false— не назначать.
Логический.
defaultType Блок с информацией о типе задачи по умолчанию. Объект.
defaultPriority Блок с информацией о приоритете задачи по умолчанию Объект.
teamUsers Массив с информацией об участниках команды очереди Массив объектов.
issueTypes Массив с информацией о типах задач очереди. Массив объектов.
versions Массив с информацией о версиях очереди Массив объектов.
workflows Список жизненных циклов очереди и их типов задач. Массив.
denyVoting Признак возможности голосования за задачи. Логический.
issueTypesConfig Массив с настройками задач очереди. Массив объектов.

Поля объекта lead

Параметр Описание Тип данных
self Ссылка на пользователя. Строка.
id Идентификатор пользователя. Строка.
display Отображаемое имя пользователя. Строка.

Поля объекта defaultType

Параметр Описание Тип данных
self Ссылка на тип задачи. Строка.
id Идентификатор типа задачи. Строка.
key Ключ типа задачи. Строка.
display Отображаемое название типа задачи. Строка.

Поля объекта defaultPriority

Параметр Описание Тип данных
self Ссылка на тип приоритета. Строка.
id Идентификатор приоритета. Строка.
key Ключ приоритета. Строка.
display Отображаемое название приоритета. Строка.

Поля объектов массива teamUsers

Параметр Описание Тип данных
self Ссылка на пользователя. Строка.
id Идентификатор пользователя. Строка.
display Отображаемое имя пользователя. Строка.

Поля объектов массива issueTypes

Параметр Описание Тип данных
self Ссылка на тип задачи. Строка.
id Идентификатор типа задачи. Строка.
key Ключ типа задачи. Строка.
display Отображаемое название типа задачи. Строка.

Поля объектов массива versions

Параметр Описание Тип данных
self Ссылка на версию очереди. Строка.
id Идентификатор версии. Строка.
display Отображаемое название версии. Строка.

Поля объектов массива workflows

Параметр Описание Тип данных
self Ссылка на тип задачи. Строка.
id Идентификатор типа задачи. Строка.
key Ключ типа задачи. Строка.
display Отображаемое название типа задачи. Строка.

Поля объектов массива issueTypesConfig

Параметр Описание Тип данных
issueType Блок с информацией о типе задачи. Объект.
workflow Блок с информацией о жизненном цикле типа задачи. Объект.
resolutions Массив с возможными резолюциями типа задачи. Массив объектов.

Поля объекта issueType

Параметр Описание Тип данных
self Ссылка на тип задачи. Строка.
id Идентификатор типа задачи. Строка.
key Ключ типа задачи. Строка.
display Отображаемое название типа задачи. Строка.

Поля объекта workflow

Параметр Описание Тип данных
self Ссылка на объект жизненного цикла. Строка.
id Идентификатор жизненного цикла. Строка.
display Отображаемое название жизненного цикла. Строка.

Поля объектов массива resolutions

Параметр Описание Тип данных
self Ссылка на объект резолюции. Строка.
id Идентификатор резолюции. Строка.
key Идентификатор резолюции. Строка.
display Отображаемое название резолюции. Строка.

Постраничное отображение результатов

Если под условия запроса попадает более 50 очередей, то для их постраничного получения необходимо использовать механизм прокрутки результатов. Для использования прокрутки в запросе используются следующие параметры:

  • perPage (необязательный)

    Количество очередей на странице. Значение по умолчанию — 50.

  • page (необязательный)

    Номер страницы ответа. Значение по умолчанию — 1.

В ответе будут содержаться следующие заголовки:

  • X-Total-Pages

    Общее количество страниц с записями.

  • X-Total-Count

    Общее число записей в ответе.

Возможные коды ответа

200
Запрос выполнен успешно.
В этой статье:
  • Формат запроса
  • Формат ответа
  • Постраничное отображение результатов
  • Возможные коды ответа
Language / Region
Вакансии
Политика конфиденциальности
Условия использования
Брендбук
© 2021 ООО «Яндекс.Облако»