Интеграция Антифрода по API
Сервис KillBot проверяет пользователя через страницу верификации. При этом он создает сайту куки "kbSession". Результат работы проверки на фрод запрашивается по этой куки.
Интеграция по АПИ доступна через наш публичный сервер: https://api.kill-bot.net. Так же можно настроить работу через ваш домен и отдельный сервер.
Получить результат проверки на фрод /
метод get
метод get
2.1
Пример: https://api.kill-bot.net/get?APIkey={APIkey}&kbSession={kbSession}
Описание параметров:
APIkey - ваш АПИ ключ (обратитесь к нам для его получения)
kbSession - кууи "kbSession"
Описание параметров:
APIkey - ваш АПИ ключ (обратитесь к нам для его получения)
kbSession - кууи "kbSession"
Ответ JSON:
{
bot: Unknown,
fraud: true,
soft: 1569215450,
loaded: true,
session: 534389081,
ua: Chrome Mobile,
action: 0
}
error: присутствует только в случае ошибки. если присутствует параметра error, то остальные параметры не отправляются.
error_string: - строка с описанием ошибки, присутствует только в случае ошибки
bot: Название бота. Поле возвращается только в случае выявления бота. Принимает значение имени бота, в случае если он есть в нашей базе. Для ботов не из нашей базы возвращается Unknown.
fraud: результат проверки на фрод. если true - значит это бот, false - означает что переход осуществлен с реального браузера.
soft: слепок программы с которой было обращение к сайту.
loaded: полностью ли был выполнен скрипт на страница верификации. true - страница верификации отработала штатно. false - страница верификации не завершила свою работу до конца. Внимание! если loaded = false, то hash = 0 и fraud = true.
session: значение куки kbSession,
ua: user agent пользователя полученный из браузерного параметра useragent
action: рекомендательное действие на бота: 0 - работать в обычном режиме,1 - дать боту доступ только чтения или отправить его в песочницу, 2 - заблокировать боту доступ к сайту. Может принимать значение в зависимости от того, в каком списке бот находится.
error_string: - строка с описанием ошибки, присутствует только в случае ошибки
bot: Название бота. Поле возвращается только в случае выявления бота. Принимает значение имени бота, в случае если он есть в нашей базе. Для ботов не из нашей базы возвращается Unknown.
fraud: результат проверки на фрод. если true - значит это бот, false - означает что переход осуществлен с реального браузера.
soft: слепок программы с которой было обращение к сайту.
loaded: полностью ли был выполнен скрипт на страница верификации. true - страница верификации отработала штатно. false - страница верификации не завершила свою работу до конца. Внимание! если loaded = false, то hash = 0 и fraud = true.
session: значение куки kbSession,
ua: user agent пользователя полученный из браузерного параметра useragent
action: рекомендательное действие на бота: 0 - работать в обычном режиме,1 - дать боту доступ только чтения или отправить его в песочницу, 2 - заблокировать боту доступ к сайту. Может принимать значение в зависимости от того, в каком списке бот находится.
Добавить бота в список /
метод add
метод add
2.2
Пример:
https://api.kill-bot.net/add
APIkey={APIkey}&soft={sort}&list={listID}
Описание параметров:
APIkey - АПИ ключ (свяжитесь с нами чтобы получить его)
soft - слепок браузера (бота)
listID - ID списка в который поместить бота
https://api.kill-bot.net/add
APIkey={APIkey}&soft={sort}&list={listID}
Описание параметров:
APIkey - АПИ ключ (свяжитесь с нами чтобы получить его)
soft - слепок браузера (бота)
listID - ID списка в который поместить бота
Ответ JSON:
{
result: 0,
error: 0,
error_string: "",
}
result: если ноль, то ошибки нет.
error: присутствует только в случае ошибки. если присутствует параметра error, то остальные параметры не отправляются.
error_string: - строка с описанием ошибки, присутствует только в случае ошибки
error: присутствует только в случае ошибки. если присутствует параметра error, то остальные параметры не отправляются.
error_string: - строка с описанием ошибки, присутствует только в случае ошибки