Добавление пользователя

Вы можете добавить пользователя в систему с помощью метода addUser.

Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения.

Администратор подразделения может добавлять пользователей только в свое подразделение и во вложенные в него подразделения.

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

Параметр	Тип	Описание
credentials (обязательный)	credentials	Смотрите описание объекта Credentials.
email (необязательный)	string	Email пользователя, которого вы добавляете.
login (обязательный)	string	Логин нового пользователя.
password (необязательный)	string	Пароль пользователя, которого вы добавляете.
departmentId (обязательный)	string	ID подразделения, в которое будет добавлен пользователь.
sendLoginEmail (необязательный, по умолчанию: true)	bool	Параметр отвечает за отправку сообщения с данными пользователю.
invitationMessage (необязательный)	string	Текст сообщения, который будет отображаться в письме.
role (обязательный)	string	Права нового пользователя.
manageableDepartmentIds (обязательный, если роль пользователя — department_administrator или publisher)	string[]	Список ID подразделений, которыми будет управлять пользователь, если его роль — администратор подразделения или автор.

Возвращаемые значения

Параметр	Тип	Описание
userId	string	ID добавленного пользователя.

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

Ошибка	Описание
User with the same email is already registered.	Пользователь с указанным email адресом уже существует.
User with the same login is already registered.	Пользователь с указанным логином уже существует.
Number of user accounts is exceeded	Превышено количество пользователей в учетной записи. Пользователь не был добавлен.
Permission Denied	У пользователя недостаточно прав для выполнения запроса. Например, Администратор подразделения может добавить пользователя только в свое подразделение.
Wrong parameters	Некоторые параметры отправлены неверно.

Пример запроса

<?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>
    <AddUserRequest>
      <credentials>
        <accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
        <email>email@email.ru</email>
        <password>password</password>
      </credentials>
      <password>password</password>
      <sendLoginEmail>true</sendLoginEmail>
      <invitationMessage>message</invitationMessage>
      <departmentId>string</departmentId>
      <role>publisher</role>
      <fields>
        <field>
          <name>login</name>
          <value>elena@ispring.ru</value>
        </field>
      </fields>
      <manageableDepartmentIds>
       <id>string</id>
       <id>string</id>
      </manageableDepartmentIds>
    </AddUserRequest>
  </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="http://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <AddUserResult>
      <userId>string<userId>
    </AddUserResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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