Создание контакта и добавление в группу — addleadtolist

Содержание [Скрыть]

1 Как работает
2 Параметры передаваемые в запросе
3 Пример на PHP (cURL)
4 Postman (импорт коллекции Expertam API)

Как работает

Данная версия API доступна на тарифах «Эксперт» и «Гуру».

Если вы не разработчик, прочитайте эту статью, она значительно облегчит использование API 2.0.

Вы можете создавать контакты и/или добавлять их в группы, формируя запрос к API сервиса программными методами. Данный метод похож на addupdatelead и является его упрощенным вариантом.

Запрос передаётся методом POST в формате URLencode на адрес: https://username.expertam.ru/api/addleadtolist, где username — это логин пользователя в системе и его домен 3-его уровня в сервисе Expertam.

В ответ на запрос ваша система получит результат выполнения функции в формате JSON. Например, такой:

{"error_code":0,"error_text":"OK","result":[],"hash":"******************************"}

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)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://username.expertam.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;

?>

<?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL => 'https://username.expertam.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 (импорт коллекции Expertam API)

У вас установлен Postman? Тогда вы можете импортировать всю коллекцию API по этой ссылке: https://www.getpostman.com/collections/9d1c9b989f68a5ac0f75

Для этого нужно:

В вашем Postman-клиенте нажать на кнопку «Import»
Выбрать вкладку «Import from link»
Ввести ссылку на нашу коллекцию https://www.getpostman.com/collections/9d1c9b989f68a5ac0f75
Нажать на кнопку «Import»

Как работает

Параметры передаваемые в запросе

Пример на PHP (cURL)

Postman (импорт коллекции Expertam API)

Статьи по теме:

Что, если я не программист? (API 2.0)

Получение списка всех купонов (скидок) — getcoupons

Получение списка продуктов — getgoods

Получение списка групп (подписки) — getalllists

Получить список дополнительных сотрудников — getpersonalmanagers

Создание счета — createorder

Оценить статью