Получить переходы
Статья создана
Обновлена 26 августа 2024 г.
Запрос позволяет получить список возможных переходов задачи. Задача выбирается при указании идентификатора или ключа задачи.
Формат запроса
Перед выполнением запроса получите доступ к API.
Для получения списка возможных переходов используйте HTTP-запрос с методом GET:
GET /v2/issues/<ключ_или_идентификатор_задачи>/transitions
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки
-
Host
Адрес узла, предоставляющего API:
api.tracker.yandex.net -
Authorization
OAuth-токен в формате
OAuth <OAuth-токен>, например:OAuth 0c4181a7c2cf4521964a72ff******** -
X-Org-ID или X-Cloud-Org-ID
Идентификатор организации. Узнать его можно на странице организаций Tracker.
- Если к Tracker привязана только организация Яндекс 360 для бизнеса, используется заголовок
X-Org-ID. - Если к Tracker привязана только организация Yandex Cloud Organization, используется заголовок
X-Cloud-Org-ID. - Если к Tracker одновременно привязаны организации Яндекс 360 для бизнеса и Yandex Cloud Organization, используется заголовок
X-Org-IDи идентификатор организации Яндекс 360 для бизнеса.
- Если к Tracker привязана только организация Яндекс 360 для бизнеса, используется заголовок
Ресурс
| Параметр | Описание | Тип данных |
|---|---|---|
| <ключ_или_идентификатор_задачи> | Идентификатор или ключ текущей задачи. | Строка |
Формат ответа
Запрос выполнен успешно
Запрос выполнен с ошибкой
В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.
Тело ответа содержит результаты в формате JSON.
[
{
"id": "resolve",
"self": "https://api.tracker.yandex.net/v2/issues/JUNE-2/transitions/resolve",
"display": "Решить",
"to": {
"self": "https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Открыт"
}
},
...
]
Параметры ответа
| Параметр | Описание | Тип данных |
|---|---|---|
| id | Идентификатор перехода. | Строка |
| self | Адрес ресурса API, который содержит информацию о переходе. | Строка |
| display | Отображаемое имя перехода. Соответствует названию кнопки в интерфейсе Tracker. | Строка |
| to | Объект с информацией о новом статусе задачи. | Объект |
Поля объекта to
| Параметр | Описание | Тип данных |
|---|---|---|
| self | Адрес ресурса API, который содержит информацию о статусе. | Строка |
| id | Идентификатор статуса. | Строка |
| key | Ключ статуса. | Строка |
| display | Отображаемое название статуса. | Строка |
- 404
- Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.