Подключиться
Yandex Tracker

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

Статья создана

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

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

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

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

GET /v2/priorities
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор организации>
Заголовки

  • Host

    Адрес узла, предоставляющего API:

    https://api.tracker.yandex.net

  • Authorization

    OAuth-токен в формате OAuth <значение токена>, например:

    OAuth 0c4181a7c2cf4521964a72ff57a34a07

  • X-Org-ID

    Идентификатор организации.

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

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

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

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

  • Используется HTTP-метод GET.
GET /v2/priorities?localized=false HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID: <идентификатор организации>

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

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

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

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

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

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