Запрос: POST /user/user_id/groups/remove
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения и пользователь с ролью с индивидуальными настройками могут удалять только пользователей подразделений, которыми управляют, и вложенных в них подразделений.
Заголовки и параметры запроса
Заголовок | Описание |
---|---|
X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, https://myaccount.ispringlearn.com. |
X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора, Администратора подразделения или пользователя с ролью с индивидуальными настройками. |
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора, Администратора подразделения или пользователя с ролью с индивидуальными настройками. |
Параметр | Описание |
user_id (обязательный) | ID пользователя, который будет исключен из групп. |
groupIds (обязательный) | Список ID групп, из которых пользователь будет исключен. |
Коды ответов
Код | Текст | Описание |
---|---|---|
204 | OK | Указанный пользователь удален. |
400 | Bad Request | Ошибка в запросе. |
401 | Unauthorized | Ошибка авторизации. |
403 | Permission Denied | У пользователя недостаточно прав для выполнения запроса. |
Пример запроса в XML
POST /user/6c45a8ca-c0ae-11ec-89d5-0242c0a8a039/groups/remove Host: api-learn.ispringlearn.com X-Auth-Account-Url: https://myaccount.ispringlearn.com X-Auth-Email: email@email.com X-Auth-Password: password <?xml version="1.0" encoding="UTF-8"?> <request> <groupIds> <id>c400156e-b9a6-11ec-b941-0242c0a8a039</id> <id>9eebd6c0-d524-11ec-be4f-0242ac150039</id> </groupIds> </request>
Пример запроса в JSON
POST /user/6c45a8ca-c0ae-11ec-89d5-0242c0a8a039/groups/remove Host: api-learn.ispringlearn.com X-Auth-Account-Url: https://myaccount.ispringlearn.com X-Auth-Email: email@email.com X-Auth-Password: password { "groupIds": [ "c400156e-b9a6-11ec-b941-0242c0a8a039", "9eebd6c0-d524-11ec-be4f-0242ac150039" ] }
Пример запроса в curl - JSON
curl -X 'POST' \ 'https://api-learn.ispring.lan/user/6c45a8ca-c0ae-11ec-89d5-0242c0a8a039/groups/remove' \ -H 'accept: */*' \ -H 'X-Auth-Account-Url: https://myaccount.ispringlearn.com' \ -H 'X-Auth-Email: email@email.com' \ -H 'X-Auth-Password: password' \ -H 'Content-Type: application/json' \ -d '{ "groupIds": [ "c400156e-b9a6-11ec-b941-0242c0a8a039", "9eebd6c0-d524-11ec-be4f-0242ac150039" ] }'
Пример запроса в curl - XML
curl -X 'POST' \ 'https://api-learn.ispring.lan/user/6c45a8ca-c0ae-11ec-89d5-0242c0a8a039/groups/remove' \ -H 'accept: */*' \ -H 'X-Auth-Account-Url: https://myaccount.ispringlearn.com' \ -H 'X-Auth-Email: email@email.com' \ -H 'X-Auth-Password: password' \ -H 'Content-Type: application/xml' \ -d '<?xml version="1.0" encoding="UTF-8"?> <request> <groupIds> <id>c400156e-b9a6-11ec-b941-0242c0a8a039</id> <id>9eebd6c0-d524-11ec-be4f-0242ac150039</id> </groupIds> </request>'
Пример овтета
https/1.1 204 OK