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

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

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

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

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

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

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

GET /v2/queues/<queue-id>/versions
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор организации>
Заголовки

  • Host

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

    https://api.tracker.yandex.net

  • Authorization

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

    OAuth 0c4181a7c2cf4521964a72ff57a34a07

  • X-Org-ID

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

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

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

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

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

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

[
    {
        "self": "https://api.tracker.yandex.net/v2/versions/49650",
        "id": 49650,
        "version": 1,
        "queue": {
            "self": "https://api.tracker.yandex.net/v2/queues/JUNE",
            "id": "1928",
            "key": "JUNE",
            "display": "june"
        },
        "name": "версия1",
        "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
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
В этой статье: