Запрос: POST /group
Оглавление minLevel 2
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют добавлять группы.
Заголовки и параметры запроса
| X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, https://myaccount.ispringlearn.ru |
| X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками. |
| X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками. |
| Параметр | Описание |
|---|---|
| name (обязательный) | Название группы. |
| userIds (необязательный) | ID пользователей, которые будут входить в состав группы. |
Заголовок | Описание |
Параметры ответа
| Параметр | Описание |
|---|---|
| response | ID добавленной группы. |
Коды ответов
| 201 | Created | Новая группа добавлена. Тело ответа будет содержать ID добавленной группы. |
| 400 | Bad Request | Ошибка в запросе. |
| 401 | Unauthorized | Ошибка авторизации. |
| 403 | Permission denied | У пользователя недостаточно прав для выполнения запроса. |
Код | Текст | Описание |
|---|
Пример запроса
| Блок кода | ||
|---|---|---|
| ||
POST /group https/1.1
Host: api-learn.ispringlearn.ru
X-Auth-Account-Url: https://myaccount.ispringlearn.ru
X-Auth-Email: email@email.com
X-Auth-Password: password
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8"?>
<request>
<name>Стажеры</name>
<userIds>
<id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id>
<id>9265e422-deb9-11e9-b4d0-864db459a4d7</id>
</userIds>
</request> |
Пример ответа
| Блок кода | ||
|---|---|---|
| ||
https/1.1 201 Created <?xml version="1.0" encoding="UTF-8"?> <response>b1496214-acab-11e9-8db0-120a62f268a9</response> |