...
| Информация |
|---|
При запросе getUser вы получите одинаковый статус для уволенных и заблокированных — 3. Чтобы различать статусы сотрудников, используйте запрос getUserV2. Так, в параметре status заблокированные сотрудники будут обозначаться статусом 3, уволенные — 5. Если в вашем аккаунте СДО более 1000 пользователей, используйте запрос Получение постраничного списка пользователей. |
Параметры запроса
| Параметр | Тип | Описание | |
|---|---|---|---|
| credentialstoken (обязательный) | credentials | string | Токен доступа. Вы можете получить токен с помощью запросаСмотрите описание объекта Credentials. |
| groupId (необязательный) | string | Если этот параметр указан, будут выбраны пользователи, которые относятся к указанной группе. | |
| departmentId (необязательный) | string | Если этот параметр указан, будут выбраны пользователи указанного подразделения. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения или пользователь с ролью с индивидуальными настройками могут получить список пользователей только своего подразделения и вложенных в него подразделений.
...
| Параметр | Тип | Описание |
|---|---|---|
| users | UserProfile[] | Массив с профилями пользователей. Объект UserProfile имеет такие же свойства, как метод getUserProfile. |
Возможные ошибки
| Ошибка | Описание |
|---|---|
| Permission denied | У пользователя недостаточно прав для выполнения запроса. Например, Администратор подразделения не может получить список пользователей другого подразделения. |
Пример запроса
| Блок кода | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<GetUsersRequest>
<credentials>
<accountUrl>https://myaccount.ispringlearn.ru</accountUrl> <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
<email>email@email.com</email>
<password>password</password>
</credentials>
</GetUsersRequest>
<groupId>string</groupId>
<departmentId>string</departmentId>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
...