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

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

https://api.tracker.yandex.net/v3/users?expand=groups

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

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

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

GET /v3/users
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

Примеры запросов:

Пример 1: Запросить информацию о пользователях, включая данные о группах, в которые они входят.

GET /v3/users?expand=groups
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID: 1234******

Пример 2: Найти пользователей по электронной почте.

GET /v3/users?email=username@example.com
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Cloud-Org-ID: ab1c******

Пример 3: Получить информацию о пользователях из определенной группы с информацией о группах.

GET /v3/users?group=5&expand=groups
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID: 1234******

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

   [
      {
      "self": "https://api.tracker.yandex.net/v3/users/12********",
      "uid": 12********,
      "login": "username",
      "trackerUid": 12********,
      "passportUid": 12********,
      "cloudUid": "bfbdrb1aa248********",
      "firstName": "Имя",
      "lastName": "Фамилия",
      "display": "Имя Фамилия",
      "email": "mail@example.com",
      "groups": [
          {
              "self": "https://api.tracker.yandex.net/v3/groups/5",
              "id": "5",
              "display": "Developers"
          }
      ],
      "external": false,
      "hasLicense": true,
      "dismissed": false,
      "useNewFilters": true,
      "disableNotifications": false,
      "firstLoginDate": "2019-08-22T14:56:57.981+0000",
      "lastLoginDate": "2022-06-22T17:44:32.981+0000",
      "welcomeMailSent": true
      },
    ...
   ]