Добавление новых контактов
Для добавления новых контактов используйте потоковую передачу данных в формате JSON через Public API.
Используйте метод Add Contact, чтобы создать или обновить профиль контакта в eSputnik.
Важно
- Этот метод не генерирует события, поэтому он не подходит для запуска сценариев.
- Метод создает контакты с подтвержденными email-адресами, как и в случае их импорта из файла. Поэтому настроить двойную подписку (DOI) нельзя.
- Если нужно записать кастомные данные о подписчиках, создайте дополнительные поля перед загрузкой контактов.
- Для добавления/обновления большого количества контактов используйте метод Add Contacts. Этот ресурс позволяет одним запросом добавлять/обновлять до 3000 контактов.
Образец тела запроса в формате JSON
В запросе Add Contact нужно передавать каналы; другие поля необязательны. Формат и описание всех полей доступны по ссылке.
{ "firstName": "John", "lastName": "Smith", "channels": [ { "type": "mobilepush", "value": "8900-7654-6456-9876-0012", "device": { "appId": "83b77a49-fc28-409b-aeaa-68c9d544ab9d", "deviceModel": "iPhone 13", "os": "Android", "locale": "uk-UA", "clientVersion": "native", "appVersion": "4.1.7", "active": true } }, { "type": "email", "value": "john.contact@gmail.com" } ], "fields": [ { "id": 12345, "value": "writer" }, { "id": 12346, "value": "1990-03-09" } ] }JSON
Валидация имен и фамилий контактов
eSputnik валидирует контактные данные, полученные поз API, по следующим правилам:
Имя
Максимальная длина значения в поле – 40 символов. Допускаются буквы любого алфавита (unicode) и до 3 цифр.
Специальные символы запрещены, исключения:
апострофы ' (в середине слова)
дефисы – (в середине слова или между словами без пробелов)
точка в конце короткого (до 3-х символов) слова (например, Jr.)
Разрешается использовать 3 слова, состоящие из более чем 3-х символов, и 3 слова, состоящие максимум из 3-х символов.
Имена, состоящие исключительно из цифр и спецсимволов, запрещены.
Фамилия
Правила валидации такие же, как и для поля “Имя”, за исключением того, что допускается любое количество слов любой длины (но суммарно не более 40 символов).