Необходимо настроить передачу лидов по API

Веб-программирование — неверно указаны категории?

472 UAH

Все запросы отправляются по протоколу HTTP на адрес . Метод запроса - GET или POST (для больших запросов рекомендуем использовать метод POST, поскольку GET имеет ограничения на размер запроса). Обязательными полями являются:

method - метод запроса;
authid - ID авторизации, не используется в методе auth, о получении ID см. раздел авторизация;
authhash - авторизационный хэш, аналогично authid генерируется при авторизации.
Все остальные параметры зависят от метода, который вызывается.

Сама работа производится по следующему принципу:

отправляем запрос авторизации;
получаем в ответ ID и хэш для отправки любых других запросов;
сохраняем ID и хэш;
с полученными авторизационными данными делаем запросы к серверу.
Внимание!
На время бета-тестирования действует временное ограничение на запросы - 100 запросов в минуту. При превышении числа запросов в результате будет приходить ошибка. Помните: даже запрос с ошибкой учитывается в количестве запросов! Т.е. если вы получили ошибку "Timeout error!" - от времени запроса с ошибкой надо отсчитать 5 секунд и только тогда делать следующий.

Это не распространяется на запросы авторизации - их таймаут учитывается отдельно и составляет 10 секунд (из соображений безопасности). Т.е. делать запросы авторизации чаще, чем раз в 10 секунд нельзя, но можно сразу после запроса авторизации делать запрос любого другого метода API.

Ответ на запрос приходит в формате JSON. Обязательными полями ответа являются:

code - код ошибки (если 0 - ошибки не было);
msg - текст сообщения об ошибке (если нет ошибки - пустое поле).
Все остальные поля ответа зависят от запрашиваемого метода.

Пример пошаговой настройки лендинга:
На своем сервере необходимо разархивировать папку api и разместить ее в корне сайта.
Настроить формы заказа следующим образом:
Все формы должны иметь следующие атрибуты: action="api/success.php", method="post";
Каждая форма должна иметь следующие поля, обязательные для заполнения: <input type="text" name="name">, <input type="tel" name="phone"> ;
Для передачи данных в полях data1-data5, необходимо перед тегом </form> добавить следующие элементы:
<input type="hidden" name="data1" value="значение">
<input type="hidden" name="data2" value="значение">
<input type="hidden" name="data3" value="значение">
<input type="hidden" name="data4" value="значение">
<input type="hidden" name="data5" value="значение">
В индексный файл своего сайта (index.html, index.php и т.д.) нужно добавить ссылки на js скрипты kma и расположить их в конце перед закрывающимся тегом </body>:
<script src="https://cdnkma.biz/custom-api.js"></script>
<script src="https://cdnkma.biz/custom.js"></script>
Откройте в браузере файл ВАШ_САЙТ/api/install.php
удостоверьтесь, что Ваш сервер удовлетворяет всем требованиям;
укажите API-ключ (token) и id потока (channel) в соответствующей форме, сохраните ее.
Для получения API-ключа, пройдите по ссылке;
Для получения id потока, создайте поток, и скопируйте выделенный фрагмент из потоковой ссылки - .
Отправьте тестовый лид, для проверки корректности настроек
В случае, если при отправке заявки возникает ошибка, необходимо включить режим отладки. Сделать это можно в файле api/config.php: define(KMA_DEBUG, true)

Авторизация производится один раз, результатом успешной авторизации является получение хэша и ID авторизации, которые потом можно будет применять в запросах. Авторизацию можно пройти повторно - ID будет возвращен старый, хэш обновится. Срока давности хэш не имеет.

Параметры запроса для авторизации:

method=auth - метод auth;
username=email - e-mail, указанный вами при регистрации;
pass=password - пароль для входа в кабинет адверта.
Пример запроса авторизации (здесь и далее в примерах для наглядности используется метод GET):

Если в ходе запроса не возникло ошибок, ответ будет примерно таким:
{"code":0,"msg":"","authid":100,"authhash":"65c6b816fc4e5a47fb1d5ceb5f3ca802"}.

Соответственно поля authid и authhash сохраняем для дальнейшего применения в запросах.