# Экспорт изменения сегментации клиентов
## Общий контракт постановки задачи экспорта

Общий контракт постановки задачи экспорта описан [здесь](https://developers.mindbox.ru/docs/%D0%BE%D0%B1%D1%89%D0%B8%D0%B9-%D0%BF%D1%80%D0%B8%D0%BD%D1%86%D0%B8%D0%BF-%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%BE%D0%B2) 

## Контракт экспорта изменения сегментации клиентов

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

```json title="JSON"
https://api.mindbox.ru/v3/operations/sync?endpointId={endpointId}&operation={operation}

Accept: application/json
Content-Type: application/json
Authorization: SecretKey {Секретный ключ}

{
  "sinceDateTimeUtc": "<Начальная дата и время, с которой необходимо получить изменения (UTC, YYYY-MM-DD hh:mm)>",
  "segmentation": {
    "ids": {
      "externalId": "<Внешний идентификатор сегментации>"
    }
  }
}
```

Во входных параметрах можно указать:

* Дату "от" в формате UTC. Тогда в выгрузку попадут только клиенты, которые вошли или вышли из запрошенной сегментации
* externalId сегментации клиентов, если таковая не была выбрана в настройках шага операции.

Если **запросить без указания даты в запросе**, то в результирующем файле будет по строчке на каждого клиента, который когда либо был в этой сегментации, в зависимости от того числится ли клиент в сегментации в текущий момент, будет указываться свойство "inSegmentation", а в свойстве "segment" будет указан сегмент, в который клиент засчитан

Если же **запрос с использованием даты "от"** то в запросе будут строчки только тех клиентов, которые на текущий момент зачислены или наоборот выпали из сегментации.

## Формат выгружаемого файла

**Описание базовых полей экспорта**

```json title="JSON"
{
  "customerSegments": [
    {
      "customer": {
        "ids": {
          "mindboxId": "<Идентификатор клиента в Mindbox>",
          "<ИД1>": "<Внешний ИД клиента>",
          "<ИД2>": "<Другой внешний ИД клиента>"
        }
      },
      "inSegmentation": true,
      "segment": {
        "ids": {
          "externalId": "<Внешний идентификатор сегмента>"
        }
      }
    },
    {
      "customer": {
        "ids": {
          "mindboxId": "<Идентификатор клиента в Mindbox>",
          "<ИД1>": "<Внешний ИД клиента>",
          "<ИД2>": "<Другой внешний ИД клиента>"
        }
      },
      "inSegmentation": false
    }
  ]
}
```