Вы можете создать новое подразделение с помощью метода 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="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <AddDepartmentRequest> <credentials> <accountUrl>http://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="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <AddDepartmentResult> <departmentId>string</departmentId> </AddDepartmentResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>