Упрощенный импорт профиля
Описание
Упрощенный импорт профиля имеет линейную структуру и предназначен для простейших интеграций.
Для получения доступа к большему функционалу воспользуйтесь методом /api/v1.1/profiles/import.
Импортирует или обновляет профиль, добавляет подписки, если передать номер ресурса и есть контактные данные.
URL-адрес
Метод: POST. Данные могут быть переданы как в параметрах URL, так и теле запроса, если это POST.
https://example.com/api/integrations/any/profile_import
Параметры запроса
| Параметр | Тип | Пример | Обязательный | Описание |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
| db_id | int | 1 | Да | Идентификатор базы данных |
| matching | string | "email" | Нет | Способ поиска профиля для обновления:
field_name вместо custom).По умолчанию – email. |
| resource_id | int | 1 | Нет | Сформировать подписку на указанный ресурс, на базе импортируемых данных. |
| string | "example@example.com" | Нет | Адрес email подписки. Также требуется при поиске по email. | |
| phone | string | "+75551111444" | Нет | Номер телефона. Также требуется при поиске по телефону. |
| _regip | string | "172.16.0.1" | Нет | IPv4 или IPv6 адрес регистрации. В случае передачи IPv4 адреса будет произведена попытка геолокации. |
| _regurl | string | "https://example.com/?" | Нет | Если не передан — будет установлен из HTTP заголовка Referer. |
| * | Можно передавать любые поля, имеющиеся в БД. Хотя бы одно поле требуется для успешного импорта. Для получения информации о полях базы данных, используйте /api/v1.1/databases/fields_get | |||
| trigger_id | int | 13 | Нет | Идентификатор триггерной кампании для запуска. Если trigger_id задан, то произойдет одновременный импорт профиля и отправка триггера, если нет — обычный импорт профиля. |
| workflow_id | int | 1 | Нет | Идентификатор цепочки. Если workflow_id задан, то произойдет одновременный импорт профиля и запуск профиля в сценарий, если нет — обычный импорт профиля. |
Ответы сервиса
Упрощенный импорт отвечает HTTP кодом и текстом ошибки в теле сообщения.
| HTTP Код | Пояснение |
|---|---|
| 200 | Успешный импорт. |
| 400 | Ошибки в формировании запроса, проверьте правильность передаваемых полей. |
| 402 | Достигнуты ограничения аккаунта по тарифу. |
| 403 | API ключ не передан или не правильный, у него нет прав на запись в базы данных. |
| 404 | Не найдена база данных для импорта или ресурс для подписки. |
| 409 | Для заданного поиска найден более чем один профиль, это значит что поиск недостаточно точен. |
| 435 | Невозможно соблюсти уникальность поля при сохранении данных, обычно это поле email, когда поиск осуществляется не по email, а, например, по кастомному полю. |
| 500 | Внутренняя ошибка сервиса. |
Пример запроса
curl "https://example.com/api/integrations/any/profile_import" \
-d token="abcdefghijklmnqrstuvwxyz" \
-d db_id=1 \
-d resource_id=1 \
-d email="john.doe@example.com" \
-d _fname="John" \
-d _lname="Doe"
Пример ответа
Successfully added 5beeea0ad861602a078a6f34