Сегментации

Получение списка сегментаций

В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.

Описание метода

Осуществляется с помощью POST-запроса. Адрес запроса настраивается в системе Майндбокс.

Code
POST https://api.mindbox.ru/v3/operations/sync?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}
HTTP/1.1

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

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

Code
POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=GetSegmentationsForCustomers
HTTP/1.1

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq

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

Code
<result>
  <status>Success</status>
  <segmentations>
    <segmentation>
      <ids>
        <externalId>{Внешний идентификатор сегментации}</externalId>
      </ids>
      <name>{Имя сегментации}</name>
      <segments>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
      </segments>
    </segmentation>
    <segmentation>
      <ids>
        <externalId>{Внешний идентификатор сегментации}</externalId>
      </ids>
      <name>{Имя сегментации}</name>
      <segments>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
      </segments>
    </segmentation>
  </segmentations>
</result>

Last modified on September 4, 2026

Получение сегментов клиента Массовый импорт статических сегментаций клиентов

Описание метода

Осуществляется с помощью POST-запроса. Адрес запроса настраивается в системе Майндбокс.

Code
POST https://api.mindbox.ru/v3/operations/sync?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}
HTTP/1.1

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

Code

POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=GetSegmentationsForCustomers
HTTP/1.1

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq

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

Code
<result>
  <status>Success</status>
  <segmentations>
    <segmentation>
      <ids>
        <externalId>{Внешний идентификатор сегментации}</externalId>
      </ids>
      <name>{Имя сегментации}</name>
      <segments>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
      </segments>
    </segmentation>
    <segmentation>
      <ids>
        <externalId>{Внешний идентификатор сегментации}</externalId>
      </ids>
      <name>{Имя сегментации}</name>
      <segments>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
        <segment>
          <ids>
            <externalId>{Внешний идентификатор сегмента}</externalId>
          </ids>
          <name>{Имя сегмента}</name>
          <count>{Количество сущностей в сегменте}</count>
        </segment>
      </segments>
    </segmentation>
  </segmentations>
</result>

Last modified on September 4, 2026