Получить приоритеты
Запрос позволяет получить список приоритетов для задачи.
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 | Признак наличия переводов в ответе. Допустимые значения:
|
Логический |
Запрос приоритетов:
- Используется 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 и через интерфейс требуются одинаковые права.