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

Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 8 Следующий »

Вы можете отредактировать смарт-группу, отправив 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 (обязательный)

Может принимать значения:

  • 1- подразделение

  • 2 - группа

  • 3 - поля профиля

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

Идентификатор поля профиля. Заполняется только для полей профиля.

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

Для подразделений:

  • 1 - одно подразделение без его дочерних подразделений
  • 2 - подразделение и все его дочерние подразделения

Для групп и полей профиля:

  • всегда 1
value (обязательный)

Для подразделений:

  • ID подразделения

Для групп:

  • ID группы

Для поля профиля:

  • значение поля профиля (например, для поля Фамилия значение — Соколов)

Внимание: для поля Страна нужно использовать ID страны, а не название. ID страны можно узнать при помощи метода Получение списка полей профиля пользователя.

Примеры правил

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

<rule>				
  <attributeType>1</attributeType>
  <attributeId></attributeId>
  <operator>2</operator>
  <value>d48bd4fa-5b70-11e9-b12b-22e9fbac4a59</value>			
</rule>

Правило для группы

<rule>				
  <attributeType>2</attributeType>
  <attributeId></attributeId>
  <operator>1</operator>
  <value>eb53de1e-dea4-11e9-8de4-0a580af40738</value>			
</rule>

Правило для поля профиля

<rule>				
  <attributeType>3</attributeType>
  <attributeId>LAST_NAME</attributeId>
  <operator>1</operator>
  <value>Соколов</value>			
</rule>

Коды ответов

Код

Текст

Описание

200Successful operationПараметр успешно изменен.
400Bad RequestОшибка в запросе.
401UnauthorizedОшибка авторизации.
403Permission 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>Стажеры</name>
	<rules>
		<and>
			<or>
				<rule>
					<attributeType>1</attributeType>
					<attributeId>3fa85f64-5717-4562-b3fc-2c963f66afa6</attributeId>
					<operator>1</operator>
					<value>string</value>
				</rule>
			</or>
		</and>
	</rules>
</request>

Пример ответа

HTTP/1.1 200 Successful operation
Connection: close
  • Нет меток