Общие принципы работы с API — База знаний Expertam

Содержание

1 URL API
2 Как вызывать
- 2.1 Чтобы получить секретный ключ API:
3 Что получаем в ответ

Для интеграции с другими сервисами и приложениями рекомендуем настроить интеграцию через Zapier.

Вы сможете передавать данные между сервисами без помощи программистов.

URL API

Функции API сервиса вызываются по адресу https://username.expertam.ru/api/ с добавлением названия функции. Например: https://username.expertam.ru/api/AddLeadToGroup.

Где username — логин вашего магазина.

Замечание: вы также можете использовать вместо username.expertam.ru собственный домен, который привязан к вашему аккаунту. Подробнее смотрите в разделе «Сайт» => «Настройки» => «Домены» в личном кабинете.

Как вызывать

Параметры передаются методом POST с кодированием URLencode. Например так:

<!--?php Send(http_build_query($send_data)); ?-->

1	<!--?php Send(http_build_query($send_data)); ?-->

где:

Send — ваша функция, отправляющая запрос на API,
http_build_query — стандартная функция PHP,
$send_data — массив передаваемых параметров.

Каждый запрос должен быть подписан. Для этого в запросе передаётся поле hash.
Формируется оно так:

<!--?php md5("$params::$user_id::$secret") ?-->

1	<!--?php md5("$params::$user_id::$secret") ?-->

где:

$params — URLencode параметры передаваемые в функцию API,
$user_id — логин в системе Expertam,
$secret — секретный ключ, который можно получить в личном кабинете аккаунта в разделе «Интеграция и API».

Чтобы получить секретный ключ API:

Перейдите в раздел API, нажав на ссылку «Интеграция и API» в футере любой страницы вашего личного кабинета:
Сам ключ API можно сразу скопировать на открывшейся странице: