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

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

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: Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.

Была ли статья полезна?

Получить права доступа группы к компоненту

Создать тип задачи