Получить переходы

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

GET

https://api.tracker.yandex.net/v3/issues/<id_задачи>/transitions

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

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

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

GET /v3/issues/<id_задачи>/transitions
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_задачи> Идентификатор или ключ текущей задачи. Строка

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

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

Тело ответа содержит результаты в формате JSON.

[
    {
        "id": "resolve",
        "self": "https://api.tracker.yandex.net/v3/issues/JUNE-2/transitions/resolve",
        "display": "Resolve",
        "to": {
            "self": "https://api.tracker.yandex.net/v3/statuses/1",
            "id": "1",
            "key": "open",
            "display": "Открыт"
        }
    },
    ...
]
Параметры ответа
Параметр Описание Тип данных
id Идентификатор перехода. Строка
self Адрес ресурса API, который содержит информацию о переходе. Строка
display Отображаемое имя перехода. Соответствует названию кнопки в интерфейсе Трекера. Строка
to Объект с информацией о новом статусе задачи. Объект

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

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