Обновить сегмент

Описание

Изменить правила построения сегмента.

URL-адрес

Метод: POST

https://example.com/api/v1.1/segments/update/

Параметры запроса

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API токен
format	string	"json"	Да	Формат возвращаемых данных (по умолчанию – "json")
id	int	1	Да	Идентификатор ресурса
name	string	"New segment"	Да	Название сегмента
segment	JSON array		Да	Правила сегментации

Пример запроса

JSON

{
  "id": 1,
  "name": "New segment",
  "segment": [
    {
      "condition": "or",
      "limit": 0,
      "list_id": 1,
      "percent_from": 0,
      "percent_to": 99,
      "queries": [
        {
          "child": [],
          "compo": "default",
          "condition": "",
          "name": "custom_tags",
          "operator": "all",
          "type": "tags",
          "value": [
            {
              "name": "default",
              "value": ["TAG_A", "TAG_B", "TAG_C", "TAG_D"]
            }
          ]
        }
      ]
    }
  ],
  "token": "abcdefghijklmnqrstuvwxyz"
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<xml>
  <id>1</id>
  <name>New segment</name>
  <segment>
    <condition>or</condition>
    <limit>0</limit>
    <list_id>1</list_id>
    <percent_from>0</percent_from>
    <percent_to>99</percent_to>
    <queries>
      <child/>
      <compo>default</compo>
      <condition>
      </condition>
      <name>custom_tags</name>
      <operator>all</operator>
      <type>tags</type>
      <value>
        <name>default</name>
        <value>TAG_A</value>
        <value>TAG_B</value>
        <value>TAG_C</value>
        <value>TAG_D</value>
      </value>
    </queries>
  </segment>
  <token>abcdefghijklmnqrstuvwxyz</token>
</xml>

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

JSON

{
  "data": {
    "saved_id": 1
  },
  "error": 0,
  "error_text": "Successful operation"
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<xml>
  <data>
    <saved_id>1</saved_id>
  </data>
  <error>0</error>
  <error_text>Successful operation</error_text>
</xml>

Возвращаемые параметры

Параметр	Тип	Описание
error	int	Код ошибки
error_text	string	Текст ошибки
saved_id	int	Идентификатор сегмента