Добавление новых контактов

Для добавления новых контактов используйте потоковую передачу данных в формате JSON через Public API.

Используйте метод Add Contact, чтобы создать или обновить профиль контакта в eSputnik.

Образец тела запроса в формате 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"
        }
    ]
}

Валидация имен и фамилий контактов

eSputnik валидирует контактные данные, полученные поз API, по следующим правилам:

Имя

Максимальная длина значения в поле – 40 символов. Допускаются буквы любого алфавита (unicode) и до 3 цифр.

Специальные символы запрещены, исключения:

• апострофы ' (в середине слова)

• дефисы – (в середине слова или между словами без пробелов)

• точка в конце короткого (до 3-х символов) слова (например, Jr.)

Разрешается использовать 3 слова, состоящие из более чем 3-х символов, и 3 слова, состоящие максимум из 3-х символов.

Имена, состоящие исключительно из цифр и спецсимволов, запрещены.

Фамилия

Правила валидации такие же, как и для поля “Имя”, за исключением того, что допускается любое количество слов любой длины (но суммарно не более 40 символов).