Включить страницу |
---|
| Лэйблы с указанием тарифа |
---|
| Лэйблы с указанием тарифа |
---|
|
...
Запрос: POST
/group/{group_id}/members
.
Права
...
для выполнения запроса
запроса: Владелец аккаунта, Администратор аккаунта, Администратор подразделенияподразделения или роль с индивидуальными настройками, которые позволяют заменять участников группы.
...
Заголовки и параметры запроса
X-Auth-Account-Url X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора или Администратора подразделения. |
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора или Администратора подразделения. |
Authorization (обязательный) |
Базовый URL аккаунта, например, http://my.ispringlearn.ru | Параметр | Описание |
---|
group_id (обязательный) | ID группы, пользователей которой |
вы хотите обновить.вы хотите заменить |
userIds (обязательный) | Массив пользователей, которых вы хотите добавить в группу |
Информация |
---|
Переданные с помощью метода пользователи полностью заменяют состав группы. То есть, переданный и пустой параметр userIds удалит всех пользователей из группы. Если переданы ID двух пользователей, все ранее включенные в группу пользователи удалятся, а два новых пользователя добавятся. Важно: Допустим, Администратор подразделения или пользователь с ролью с индивидуальными настройками, которые позволяют заменять участников группы, отправили список новых пользователей, которых надо добавить в группу. В группе есть существующие пользователи - из управляемых ими подразделений и из подразделений, к которым они доступа не имеют. После выполнения метода в группу добавятся новые пользователи, указанные в запросе, а удалятся только те, которые входят в состав подразделений, которыми Администратор подразделения или пользователь с ролью с индивидуальными настройками управляют, и их дочерних подразделений. Пользователи, которые входят в состав подразделений, к которым Администратор подразделения или пользователь с ролью с индивидуальными настройками доступа не имеют, останутся в группе |
Коды ответов
Successful operation | Параметр успешно изменен.OK | Замена пользователей произошла успешно |
400 | Bad Request | Ошибка в запросе |
. |
401 | Unauthorized | Ошибка авторизации |
. |
403 | Permission denied | У пользователя недостаточно прав для выполнения запроса |
.Пример запроса
Блок кода |
---|
|
POST /group/b1496214-acab-11e9-8db0-120a62f268a9/members HTTPhttps/1.1
Host: api-learn.ispringlearn.ru
X-Auth-Account-Url: http://myaccount.ispringlearn.ru
X-Auth-Email: email@email.com
X-Auth-Password: password
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8"?>
<request>
<userIds>
<id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id>
</userIds>
</request> |
Пример ответа
Блок кода |
---|
|
HTTPhttps/1.1 200 Successful operation
Connection: closeOK |