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

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

GET

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

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

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

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

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

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

Параметры запроса

Дополнительные параметры

Параметр Описание Тип данных
localized Признак наличия переводов в ответе. Допустимые значения:
  • true — В ответе содержатся описания приоритетов только на языке пользователя. Значение по умолчанию.
  • false — В ответе содержатся описания приоритетов на всех языках.
Логический

Запрос приоритетов:

  • Используется HTTP-метод GET.
GET https://api.tracker.yandex.net/v3/priorities?localized=false

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

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

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

[
    {
        "self": "https://api.tracker.yandex.net/v3/priorities/5",
        "id": 5,
        "key": "normal",
        "version": 1341632717561,
        "name": "Средний",
        "order": 5
    },
    ...
]  
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о приоритете. Строка
id Идентификатор приоритета. Число
key Ключ приоритета. Строка
version Версия приоритета. Число
name Отображаемое название приоритета. При переданном в запросе localized=false данный параметр будет содержать дубликаты названия на других языках. Строка
order Вес приоритета. Параметр влияет на порядок отображения приоритета в интерфейсе. Число

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.