Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Информация

При запросе getUserProfile вы получите одинаковый статус для уволенных и заблокированных — 3

Чтобы различать статусы сотрудников, используйте запрос getUserProfileV2. Так, в параметре status заблокированные сотрудники будут обозначаться статусом 3, уволенные — 5.

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

ПараметрТипОписание
token (обязательный)stringТокен доступа. Вы можете получить токен с помощью запроса
userId (обязательный)stringID пользователя, информацию о котором вы хотите получить

Права пользователя для выполнения запроса

...

После успешной обработки запроса система возвращает массив данных со следующими свойствами:

ПараметрТипОписание
userIdstringID пользователя
statusint

Статус пользователя:

1 — активный,

3 — неактивный,

5 — уволенный

departmentIdstringПодразделение, в котором состоит пользователь
emailstringEmail пользователя
groupsstring[]ID групп, в которых состоит пользователь
fieldsstring[][2]Поля профиля пользователя (UserFields) — массив объектов со следующими свойствами: Id, value
addedDatedateДата добавления пользователя
lastLoginDatedateДата последнего входа пользователя в аккаунт
manageableDepartmentIdsstring[]ID подразделений, которыми управляет пользователь, если его роль — администратор подразделения или автор
rolestringРоль пользователя
subordination (необязательный)arrayОбъект с данными о типе подчинения линейного руководителя
coSubordination (необязательный)arrayОбъект с данными о типе подчинения функционального руководителя
subordinationType (обязательный)string

Тип подчинения линейного и функционального руководителя.

Возможные значения:

  • inherit — Наследуется от вышестоящего подразделения.,
  • manual — Указать вручную.,
  • no_supervisor — Без руководителя
workLeaveStatus (необязательный)string

Рабочий статус отсутствия. Массив с параметрами:

  • workLeaveReason — причины отсутствия,
  • startDate — дата начала отсутствия. Указывается в формате yyyy-mm-dd,
  • endDate — дата завершения отсутствия. Указывается в формате yyyy-mm-dd
supervisorId (необязательный)stringID руководителяУказываете, если subordinationType = manual
-Если subordinationType = inherit, no_supervisor, указывать не нужно

Возможные ошибки

ОшибкиОписание
Unknown userПользователь с указанным ID не найден
Permission deniedУ пользователя недостаточно прав для получения информации

...