Включить страницу | ||||
---|---|---|---|---|
|
...
Запрос: POST
/group/smart/{group_id}
...
Оглавление minLevel 2
Права для выполнения запроса
Владелец
...
аккаунта, Администратор аккаунта, Администратор
...
подразделения или роль с индивидуальными настройками, которые позволяют редактировать
...
группы.
...
Заголовки и параметры запроса
Заголовок | Описание | |
---|---|---|
Authorization (обязательный) | Токен доступа. Вы можете получить токен с помощью запроса | |
group_id | X-Auth-Account-Url(обязательный) | Базовый URL аккаунта, например, http://my.ispringlearn.ru |
X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора или Администратора подразделения. | |
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора или Администратора подразделения. | |
Параметр | Описание | |
group_id (обязательный) | ID смарт-группы, которую вы хотите отредактировать. | name (обязательный) | Название смарт
ID смарт-группы, которую вы хотите отредактировать | ||
Параметр | Описание | |
name (необязательный) | Название смарт-группы | |
attributeType (обязательный) | Может принимать значения: | |
attributeId (необязательный) | Идентификатор поля профиля. Заполняется только для полей профиля | |
operator (обязательный) | Для подразделений:
Для групп и полей профиля:
| |
value (обязательный) | Для подразделений:
Для групп:
Для поля профиля:
Внимание: для поля Страна нужно использовать ID страны, а не название. ID страны можно узнать при помощи метода Получение списка полей профиля пользователя |
Информация |
---|
Вы можете добавить несколько групп условий для добавления пользователей в смарт-группу. Они будут работать по принципу «И», то есть должны будут сработать одновременно. Внутри этих групп создайте любое число правил. Они, напротив, работают по принципу «ИЛИ», то есть достаточно выполнения одного из правил. Подробнее о смарт-группах и их условиях читайте в статье Смарт-группы. |
Коды ответов
Код | Текст | Описание | |
---|---|---|---|
200 | Successful operation | OK | Смарт-группа успешно измененаПараметр успешно изменен. |
400 | Bad Request | Ошибка в запросе. | |
401 | Unauthorized | Ошибка авторизации. | |
403 | Permission denied | У пользователя недостаточно прав для выполнения запроса. |
Пример запроса
Блок кода | ||
---|---|---|
| ||
POST /group/smart/b1496214-acab-11e9-8db0-120a62f268a9/ 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> <name>Стажеры< <name>New Group</name> <rules> <and> <or> <rule> <attributeType>1</attributeType> <attributeId>3fa85f64-5717-4562-b3fc-2c963f66afa6</attributeId> <operator>1</operator> <value>string</value> </rule> </or> </and> <and> <or> <rule> <attributeType>1</attributeType> <attributeId></attributeId> <operator>1</operator> <value>6f774f46-de00-11e9-bb11-0a580af40984</value> </rule> </or> <or> <rule> <attributeType>2</attributeType> <attributeId></attributeId> <operator>1</operator> <value>eb53de1e-dea4-11e9-8de4-0a580af40738</value> </rule> </or> <or> <rule> <attributeType>3</attributeType> <attributeId>JOB_TITLE</attributeId> <operator>1</operator> <value>Sales Manager</value> </rule> </or> </and> </rules> </request> |
Пример ответа
Блок кода | ||
---|---|---|
| ||
HTTPhttps/1.1 200 Successful operation Connection: closeOK |
Информация |
---|
С помощью данного запроса задаются новые правила для уже существующей группы. Cтарые правила команды полностью перезапишутся. |