Метод: addDepartment
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| name (обязательный) | string | Название нового подразделения. |
| parentDepartmentId (обязательный) | string | ID родительского подразделения. |
| code (необязательный) | string | Код подразделения. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта или роль с индивидуальными настройками.
Возвращаемые значения
После того, как запрос был успешно обработан, система отправляет объект со следующими свойствами:
Параметр | Тип | Описание |
|---|---|---|
departmentId | string | ID добавленного подразделения. |
Возможные ошибки
| Тип | Описание |
|---|---|
| Permission denied | Недостаточно прав у пользователя для добавления подразделений. |
| Wrong parameters | Не удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно. |
Пример запроса
<?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>
<AddDepartmentRequest>
<credentials>
<accountUrl>https://myaccount.ispringlearn.ru</accountUrl>
<email>email@email.com</email>
<password>password</password>
</credentials>
<name>string</name>
<parentDepartmentId>string</parentDepartmentId>
<code>string</code>
</AddDepartmentRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример ответа
<?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>
<AddDepartmentResult>
<departmentId>string</departmentId>
</AddDepartmentResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>