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

Получить информацию о текущем пользователе

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

Запрос позволяет получить информацию об учетной записи пользователя, от имени которого выполняется обращение к API.

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

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

GET /v2/myself
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

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

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

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

[
   {
   "self": "https://api.tracker.yandex.net/v2/users/1234567890",
   "uid": 1234567890,
   "login": "<user_login>",
   "trackerUid": 1234567890>,
   "passportUid": 1234567890,
   "firstName": "<Имя>",
   "lastName": "<Фамилия>",
   "display": "<Имя Фамилия>",
   "email": "<login@yandex.ru>",
   "external": false,
   "hasLicense": true,
   "dismissed": false,
   "useNewFilters": true,
   "disableNotifications": false
   }
]

Параметры ответа

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию об учетной записи пользователя. Строка
uid Уникальный идентификатор учетной записи пользователя. Число
login Логин пользователя. Строка
trackerUid Уникальный идентификатор аккаунта пользователя в Tracker. Число
passportUid Уникальный идентификатор аккаунта пользователя на Яндексе. Число
firstName Имя пользователя. Строка
lastName Фамилия пользователя. Строка
display Отображаемое имя пользователя. Строка
email Электронная почта пользователя. Строка
external Служебный параметр. Логический
hasLicense Признак наличия у пользователя полного доступа к Tracker:
  • true — полный доступ;
  • false — только чтение.
 Логический
dismissed Статус пользователя в организации:
  • true — пользователь удален из организации;
  • false — действующий сотрудник организации.
 Логический
useNewFilters Служебный параметр. Логический
disableNotifications Признак принудительного отключения уведомлений для пользователя:
  • true — уведомления отключены;
  • false — уведомления включены.
 Логический

Возможные коды ответа

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