Клиент
Массовый импорт клиентов
В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.
Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.
Описание метода
Осуществляется с помощью POST-запроса. Адрес запроса и набор принимаемых полей настраиваются в системе Майндбокс.
Массовый импорт клиентов
Параметры запроса
- csvCodePage - идентификатор кодовой страницы Windows для CSV-файла. Предпочтительно использовать 65001 (UTF-8).
- csvColumnDelimiter - символ, использующийся для разделения колонок в CSV-файле.
- csvTextQualifier - символ, опционально добавляющийся в начале и в конце значения колонки, позволяя использовать в нём символы, обычно не разрешённые.
- endpointId - точка доступа, из которой будут взяты настройки интеграции. Значение настраивается в системе.
- segment - cистемное имя сегмента
- SourceActionTemplate - действие регистрации клиента. Например, "Регистрация на сайте" или "Заполнение бумажной анкеты в магазине". Значение настраивается в системе.
- transactionId - ключ идемпотентности, позволяющий избежать повторного выполнения запроса. Ключ идемпотентности обязательно создавать в формате GUID (рекомендуется версия 4). Для повторных запросов c повторяющимся ключом в ответ вернется статус
TransactionAlreadyProcessed. - данный сервис разрешает поставить не более 60 импортов в час. После превышения порога вы будете получать 429 Too Many Requests до тех пор, пока количество поставленных задач за час не опустится ниже 60.
- максимальный размер принимаемого файла 200мб. В случае, если необходимо загрузить больший объем данных, данные нужно разбить на несколько файлов.
- поддерживается формат gzip. Для этого веб-сервер должен вернуть заголовок Content-Encoding: gzip. При этом файл нужно прикрепить в бинарном виде (например, binary в postman)
Описание полей данных импорта
| Заголовок | Описание |
|---|---|
| Websiteid | Идентификатор клиента на сайте |
| FirstName | Имя клиента |
| LastName | Фамилия клиента |
| MiddleName | Отчество клиента |
| MobilePhone | Мобильный телефон |
| Емэйл клиента | |
| BirthDate | Дата рождения в формате yyyy-MM-dd |
| SourceDateTimeUtc | Дата регистрации в формате yyyy-MM-dd HH:mm |
| SourcePointOfContact | Точка контакта регистрации, например "Сайт" или "Магазин на Тверской" |
| IsSubscribed | Статус подписки true/false |
| Дополнительное поле клиента | Значение дополнительного поля клиента |
Все принимаемые поля описаны тут https://{системное_имя_проекта}.mindbox.ru/customers/import
Пример запроса
Массовый импорт клиентов
Last modified on