Перейти к содержимому
AdQuest

Интеграция виджета

Интеграция виджета

Руководство по подключению AdQuest Widget на ваш сайт.

Получение Site Key

После верификации сайта:

  1. Откройте детали сайта в панели управления
  2. Скопируйте Site Key (начинается с pk_)
  3. Скопируйте Secret Key для серверной валидации

Документация по интеграции

Полная документация по интеграции AdQuest Widget доступна в отдельном разделе:

API Reference

Полное описание API и методов

Краткий пример

Минимальная интеграция виджета:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://cdn.ad-quest.ru/widget/v1/adquest-widget.min.css">
</head>
<body>
  <form id="myForm" action="/submit" method="POST">
    <input type="text" name="name" placeholder="Ваше имя" required>


    <div id="adquest-captcha"></div>
    <input type="hidden" id="adquest-token" name="adquest_token">


    <button type="submit">Отправить</button>
  </form>


  <script src="https://cdn.ad-quest.ru/widget/v1/adquest-widget.min.js"></script>
  <script>
    AdQuest.init({
      siteKey: 'YOUR_SITE_KEY',
      container: document.getElementById('adquest-captcha'),
      onSuccess: function(token) {
        document.getElementById('adquest-token').value = token;
      }
    });
  </script>
</body>
</html>

Замените YOUR_SITE_KEY на ваш реальный Site Key из панели управления.

Проверка токена на сервере

После получения токена на клиенте, проверьте его на сервере:

Окно терминала
curl -X POST https://api.ad-quest.ru/verify \
  -H "Content-Type: application/json" \
  -d '{
    "token": "USER_TOKEN",
    "siteKey": "YOUR_SITE_KEY",
    "secretKey": "YOUR_SECRET_KEY"
  }'

Ответ:

{
  "success": true,
  "timestamp": "2024-02-15T10:30:00Z"
}

Подробнее о проверке токенов см. API Reference.

Частые вопросы

Виджет не отображается

Проверьте:

  • Правильность Site Key
  • Подключены ли CSS и JS файлы
  • Нет ли ошибок в консоли браузера
  • Верифицирован ли домен

Подробнее см. Решение проблем.

Как изменить внешний вид виджета?

См. Конфигурация виджета.

Можно ли использовать на нескольких страницах?

Да, один Site Key работает на всех страницах вашего домена.

Дополнительные ресурсы