Вы можете получить информацию о пользователе с помощью метода getUserProfile.
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения.
Администратор подразделения может получать информацию о пользователях только своего подразделения и вложенных в него подразделений.
Параметры
Параметр | Тип | Описание |
---|---|---|
credentials (required) | credentials | Смотрите описание объекта Credentials. |
userId (required) | string | ID пользователя, информацию о котором вы хотите получить. |
Возвращаемые значения
После успешной обработки запроса система возвращает массив данных со следующими свойствами:
Параметр | Тип | Описание |
---|---|---|
userId | string | ID пользователя. |
status | int | Статус пользователя: 1 - активный, 2 - удален, 3 - неактивный. |
departmentId | string | Подразделение, в котором состоит пользователь. |
string | Email пользователя. | |
groups | string[] | ID групп, в которых состоит пользователь. |
fields | string[][2] | Поля профиля пользователя (UserFields) - массив объектов со следующими свойствами: Id, value. |
addedDate | date | Дата добавления пользователя. |
lastLoginDate | date | Дата последнего входа пользователя в аккаунт. |
manageableDepartmentIds | string[] | ID подразделений, которыми управляет пользователь. |
Возможные ошибки
Ошибки | Описание |
---|---|
Unknown user | Пользователь с указанным ID не найден |
Permission denied | У пользователя недостаточно прав для получения информации. |
Пример запроса
<?xml version="1.0" encoding="utf-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <GetUserProfileRequest> <credentials> <accountUrl>http://myaccount.ispringlearn.ru</accountUrl> <email>email@email.com</email> <password>password</password> </credentials> <userId>string</userId> </GetUserProfileRequest> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Пример ответа
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <ns1:GetUserProfileResult> <ns1:userProfile> <ns1:userId>1</ns1:userId> <ns1:fields> <ns1:field> <ns1:Id>login</ns1:Id> <ns1:value>test</ns1:value> </ns1:field> <ns1:field> <ns1:Id>first_name</ns1:Id> <ns1:value/> </ns1:field> <ns1:field> <ns1:Id>last_name</ns1:Id> <ns1:value/> </ns1:field> <ns1:field> <ns1:Id>email</ns1:Id> <ns1:value>test@test.test</ns1:value> </ns1:field> <ns1:field> <ns1:Id>country_id</ns1:Id> <ns1:value/> </ns1:field> <ns1:field> <ns1:Id>customfield</ns1:Id> <ns1:value/> </ns1:field> <ns1:status>1</ns1:status> <ns1:departmentId>string</ns1:departmentId> <ns1:addedDate>date</ns1:addedDate> <ns1:lastLoginDate>date</ns1:lastLoginDate> <ns1:manageableDepartmentIds> <id>string</id> <id>string</id> </ns1:manageableDepartmentIds> </ns1:userProfile> </ns1:GetUserProfileResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>