Получить список типов задач

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

GET

https://api.tracker.yandex.net/v3/issuetypes

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

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

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

GET /v3/issuetypes
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.

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

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

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

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

[
    {
    "self": "https://api.tracker.yandex.net/v3/issuetypes/1",
    "id": 1,
    "version": 1,
    "key": "task",
    "name": "Задача",
    "description": "A task that needs to be done."
    }
]
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о типе задачи. Строка
id Уникальный идентификатор типа задачи в Трекере. Число
version Версия типа задачи. Число
key Ключ типа задачи. Строка
name Отображаемое название типа задачи. Строка
description Описание типа задачи. Строка
deleted Признак удаленного типа задачи:
  • true — тип задачи удален;
  • параметр отсутствует, если тип задачи не удален.
 Логический
401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
Предыдущая
Получить права доступа группы к компоненту
Следующая
Получить список статусов