Получить версии очереди

Запрос позволяет получить информацию о версиях очереди. Очередь выбирается при указании идентификатора или ключа.

GET

https://api.tracker.yandex.net/v3/queues/<id_очереди>/versions

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

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

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

GET /v3/queues/<id_очереди>/versions
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки

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

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Трекеру привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Трекеру привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
<id_очереди> Идентификатор или ключ очереди. Ключ очереди чувствителен к регистру символов. Строка или число

Пример: Получить версии очереди TEST.

  • Используется HTTP-метод GET.
GET https://api.tracker.yandex.net/v3/queues/TEST/versions

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

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

[
    {
        "self": "https://api.tracker.yandex.net/v3/versions/49***",
        "id": 49***,
        "version": 1,
        "queue": {
            "self": "https://api.tracker.yandex.net/v3/queues/JUNE",
            "id": "1928",
            "key": "JUNE",
            "display": "june"
        },
        "name": "My version",
        "description": "iohb ±!@#$%^&*()_+=-/\\?<>.,/§:»'|;",
        "startDate": "2017-06-09",
        "dueDate": "20227-06-09",
        "released": false,
        "archived": false
    },
    ...
]
Параметры ответа
Параметр Описание Тип данных
self Ссылка на объект версии Строка
id Идентификатор версии Число
version Номер версии Число
queue Объект с информацией об очереди Объект
name Название версии Строка
description Текстовое описание версии Строка
startDate Начальная дата очереди Строка
dueDate Конечная дата очереди Строка
released Признак выпущенной версии Логический
archived Признак архивной версии Логический

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

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

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

404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
Предыдущая
Создать версию очереди
Следующая
Получить обязательные поля очереди