Вы можете удалить подразделение с помощью метода removeDepartment.
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения.
Администратор подразделения может удалить только подразделение, которым управляет, и его дочерние подразделения.
| Информация |
|---|
Нельзя удалить подразделение: - в котором есть пользователи,
- которым управляет администратор подразделения или автор,
- если оно является корневым.
|
Параметры запроса
| Параметр | Тип | Описание |
|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| departmentId (обязательный) | string | ID подразделения, которое нужно удалить. |
Возвращаемые значения
После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:
| Параметр | Тип | Описание |
|---|
| success | bool | True, если подразделение было удалено. |
Возможные ошибки
Ошибка | Описание |
|---|
| Permission denied | У пользователя недостаточно прав для удаления подразделения. |
| Wrong parameters | Подразделение с указанным ID не найдено, содержит пользователей или является корневым подразделением. |
Пример запроса
| Блок кода |
|---|
|
<?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>
<RemoveDepartmentRequest>
<credentials>
<accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
<email>email@email.com</email>
<password>password</password>
</credentials>
<departmentId>string</departmentId>
</RemoveDepartmentRequest>
</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>
<successResult>
<success>true</success>
</successResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |