Включить страницу |
---|
| Лэйблы с указанием тарифа |
---|
| Лэйблы с указанием тарифа |
---|
|
Метод: listUsers
Информация |
---|
При запросе listUsers вы получите одинаковый статус для уволенных и заблокированных — 3. Чтобы различать статусы, используйте запрос listUsersV2. Так, в параметре status заблокированные сотрудники будут обозначаться статусом 3, уволенные — 5.
Если в вашем аккаунте LMS более 1000 пользователей, используйте запрос Получение постраничного списка пользователей. |
Метод
...
Параметры запроса
credentials credentials | Смотрите описание объекта Credentialsstring | Токен доступа. Вы можете получить токен с помощью запроса. |
groupId (необязательный) | string | Если этот параметр указан, будут выбраны пользователи, которые относятся к указанной группе. |
departmentId (необязательный) | string | Если этот параметр указан, будут выбраны пользователи указанного подразделения. |
pageSize (необязательный) | string | Количество записей на 1 страницу. Если не указан, то 1000. |
pageToken (необязательный) | string | Токен для перехода на следующую страницу |
. . |
logins (необязательный) | string | Массив логинов пользователей, список которых вы хотите получить. |
emails (необязательный) | string | Массив email-адресов пользователей, список которых вы хотите получить. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Администратор подразделения может , Автор или пользователь с ролью с индивидуальными настройками могут получить список пользователей только своего подразделения и вложенных в него подразделений.
...
После того, как запрос успешно обработан, система возвращает объект со следующими свойствами:
Параметр | Тип | Описание |
---|
users | UserProfile[] | Массив с профилями пользователей. Объект UserProfile имеет такие же свойства, как метод getUserProfile. |
nextPageToken | string | Токен для перехода на следующую страницу. |
workLeaveStatus (необязательный) | string | Рабочий статус отсутствия. Массив с параметрами: - workLeaveReason — причины отсутствия,
- startDate — дата начала отсутствия. Указывается в формате yyyy-mm-dd,
- endDate — дата завершения отсутствия. Указывается в формате yyyy-mm-dd.
|
Возможные ошибки
Ошибка | Описание |
---|
Permission denied | У пользователя недостаточно прав для выполнения запроса. Например, администратор подразделения не может получить список пользователей другого подразделения, которым не управляет. |
Пример запроса
Блок кода |
---|
|
<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="httphttps://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="httphttps://ispringlearn.com/go/services/api/soap">
<soapenv:Header/>
<soapenv:Body>
<soap:ListUsersRequest>
<soap:credentials>
<soap:accountUrl>http://myaccount.ispringlearn.ru< <soap:token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</soap:accountUrl>token>
<soap:email>email@email.com</soap:email>
<soap:password>password</soap:password>
</soap: </soap:credentials>
<soap:groupIds>
<soap:id>string</soap:id>
</soap:groupIds>
<soap:departmentIds>
<soap:id>string</soap:id>
</soap:departmentIds>
<soap:pageToken>string</soap:pageToken>
<soap:pageSize>1000</soap:pageSize>
</soap:ListUsersRequest>
</soapenv:Body>
</soapenv:Envelope> |
...
Блок кода |
---|
|
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="httphttps://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<ns1:ListUsersResult>
<ns1:userProfiles>
<ns1:userProfile>
<ns1:userId>string</ns1:userId>
...
</ns1:userProfile>
<ns1:userProfile>
<ns1:userId>string</ns1:userId>
...
</ns1:userProfile>
<ns1:userProfile>
<ns1:userId>string</ns1:userId>
...
</ns1:userProfile>
</ns1:userProfiles>
<ns1:nextPageToken>string</ns1:nextPageToken>
</ns1:ListUsersResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
...