Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Включить страницу
Лэйблы с указанием тарифа
Лэйблы с указанием тарифа

Запрос:

...

POST /user/{user_id}/groups/remove

Оглавление
minLevel2

Права для выполнения запроса 

Владелец аккаунтаАдминистратор аккаунтаАдминистратор подразделения или роль с индивидуальными настройками.

Администратор подразделения и пользователь с ролью с индивидуальными настройками могут удалять только пользователей подразделений, которыми управляют, и вложенных в них подразделений.

Заголовки и параметры запроса

Заголовок

Описание

X-Auth-Account-Url X-Auth-Email (обязательный)Логин Владельца аккаунтаАдминистратора, Администратора подразделения или пользователя с ролью с индивидуальными настройками.X-Auth-Password (обязательный)Пароль Владельца аккаунтаАдминистратора, Администратора подразделения или пользователя с ролью с индивидуальными настройками.

Authorization (обязательный)

Базовый URL аккаунта, например, https://myaccount.ispringlearn.com.
Токен доступа. Вы можете получить токен с помощью запроса
ПараметрОписание
user_id (обязательный)ID пользователя,
которого вы хотите удалить.
который будет исключен из групп
groupIds (обязательный)Список
идентификаторов
ID групп, из которых будет исключен пользователь
будет удален.

Коды ответов

Код

Текст

Описание

204OKУказанный пользователь удален
.
400Bad RequestОшибка в запросе
.
401UnauthorizedОшибка авторизации
.
403Permission 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: passwordru 
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE 
 
<?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
 
ru 
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
   
 {
  "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' Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE' \
  -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: passwordAuthorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE' \
  -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

...