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

Запрос позволяет получить параметры версии очереди.

GET

https://api.tracker.yandex.net/v3/versions/{id_версии}

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

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

Чтобы получить версию очереди, используйте HTTP-запрос с методом GET.

GET /v3/versions/{id_версии}
Host: api.tracker.yandex.net
Authorization: OAuth API_TOKEN
X-Org-ID или X-Cloud-Org-ID: ИДЕНТИФИКАТОР_ОРГАНИЗАЦИИ
Заголовки

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

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

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

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

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

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

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

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

Ресурс
Параметр Описание Тип данных
id_версии Идентификатор версии. Число
Параметры запроса
Параметр Описание Тип данных
fields Список возвращаемых полей через запятую: version, queue, name, description, startDate, dueDate, releasedAt, released, archived, next. Поля self и id возвращаются всегда. Строка

Если передать в заголовке If-None-Match значение заголовка ETag из предыдущего ответа, при отсутствии изменений API возвращает код 304 без тела ответа.

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

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

Тело ответа содержит JSON-объект с параметрами версии.

{
    "self": "https://api.tracker.yandex.net/v3/versions/123",
    "id": 123,
    "version": 1,
    "queue": {
        "self": "https://api.tracker.yandex.net/v3/queues/TEST",
        "id": "1",
        "key": "TEST",
        "display": "Тестовая очередь"
    },
    "name": "Версия 1.0",
    "description": "Описание версии",
    "startDate": "2026-08-26",
    "dueDate": "2026-08-27",
    "released": false,
    "archived": false
}
Параметры ответа
Параметр Описание Тип данных
self Ссылка на объект версии. Строка
id Идентификатор версии. Число
version Номер версии. Число
queue Очередь, к которой относится версия. Объект
name Название версии. Строка
description Описание версии. Строка
startDate Дата начала версии в формате YYYY-MM-DD. Строка
dueDate Дата завершения версии в формате YYYY-MM-DD. Строка
released Признак выпущенной версии. Логический
archived Признак архивной версии. Логический

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

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

Если версия не найдена, API возвращает код ошибки:

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