Вы можете отредактировать смарт-группу, отправив POST запрос на URL: /group/smart/{group_id}.
Роль пользователя для выполнения запроса: Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют редактировать смарт-группы.
Запрос
Заголовок | Описание |
---|---|
X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, http://myaccount.ispringlearn.ru |
X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками, которые позволяют редактировать смарт-группы. |
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками, которые позволяют редактировать смарт-группы. |
Параметр | Описание |
group_id (обязательный) | ID смарт-группы, которую вы хотите отредактировать. |
name (необязательный) | Название смарт-группы. |
attributeType (обязательный) | Может принимать значения: |
attributeId (необязательный) | Идентификатор поля профиля. Заполняется только для полей профиля. |
operator (обязательный) | Для подразделений:
Для групп и полей профиля:
|
value (обязательный) | Для подразделений:
Для групп:
Для поля профиля:
Внимание: для поля Страна нужно использовать ID страны, а не название. ID страны можно узнать при помощи метода Получение списка полей профиля пользователя. |
Коды ответов
Код | Текст | Описание |
---|---|---|
200 | Successful operation | Параметр успешно изменен. |
400 | Bad Request | Ошибка в запросе. |
401 | Unauthorized | Ошибка авторизации. |
403 | Permission denied | У пользователя недостаточно прав для выполнения запроса. |
Пример запроса
POST /group/smart/b1496214-acab-11e9-8db0-120a62f268a9/ HTTP/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 Content-Type:application/xml <?xml version="1.0" encoding="UTF-8"?> <request> <name>New Group</name> <rules> <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>14072df2-d54f-11e9-a7ce-0a580af40973</attributeId> <operator>1</operator> <value>Менеджер</value> </rule> </or> </and> </rules> </request>
Пример ответа
HTTP/1.1 200 Successful operation Connection: close