Описание
Упрощенный импорт профиля имеет линейную структуру, и предназначен для простейших интеграций.
Для получения доступа к большему функционалу воспользуйтесь методом /api/v1.1/profiles/import.
Импортирует или обновляет профиль, добавляет подписки, если передать номер ресурса и есть контактные данные.
URL-адрес
Методы: POST или GET. Данные могут быть переданы как в параметрах 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 |
Ответы сервиса
Упрощенный импорт отвечает 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