Содержание
Как работает
Если вы не разработчик, прочитайте эту статью, она значительно облегчит использование API 2.0.
Вы можете создавать контакты и/или добавлять их в группы, формируя запрос к API сервиса программными методами. Данный метод похож на addupdatelead и является его упрощенным вариантом.
Запрос передаётся методом POST в формате URLencode на адрес: https://username.justclick.ru/api/addleadtolist, где username — это логин пользователя в системе и его домен 3-его уровня в сервисе JustClick.
В ответ на запрос ваша система получит результат выполнения функции в формате JSON. Например, такой:
1 |
{"error_code":0,"error_text":"OK","result":[],"hash":"******************************"} |
Подробнее смотрите «Ответы API сервиса».
Параметры передаваемые в запросе
Параметры запроса следующие, обязательными являются оба параметра:
- rpsKey — ключ API; ключ для вашего аккаунта находится в разделе «Интеграция и API», ссылка на раздел находится в футере личного кабинета или вот /shops/setts/apisettings/
- lead_email — email контакта (если не указан, будет создан без емейла); строка
- add_to_lists — в какие группы добавлять контакт; строка, указываются ID групп(ы), через запятую (редактирование группы => вкладка API, например 1473249885.2899961004)
Пример на PHP (cURL)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://username.justclick.ru/api/addleadtolist', //не забудьте заменить username CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => 'rpsKey={подставьте ваш ключ API}&lead_email={подставьте нужный email}&add_to_lists={перечислите группы, в формате, указанном в описании}', CURLOPT_HTTPHEADER => array( 'Content-Type: application/x-www-form-urlencoded' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; ?> |
Postman (импорт коллекции JustClick API)
У вас установлен Postman? Тогда вы можете импортировать всю коллекцию API по этой ссылке: https://www.getpostman.com/collections/9d1c9b989f68a5ac0f75
Для этого нужно:
- В вашем Postman-клиенте нажать на кнопку «Import»
- Выбрать вкладку «Import from link»
- Ввести ссылку на нашу коллекцию https://www.getpostman.com/collections/9d1c9b989f68a5ac0f75
- Нажать на кнопку «Import»