Как решить reCAPTCHA v3 Enterprise на сайте waze.com

Введение

Это руководство описывает интеграцию с RuCaptcha для обхода reCAPTCHA v3 Enterprise на сайте https://www.waze.com/live-map.

Ключевой момент: reCAPTCHA v3 возвращает токен с оценкой (score). Waze принимает решение на основе этого score, поэтому параметр minScore критически важен. Начните с 0.3 и при необходимости корректируйте.

Общие сведения

Для Waze используется Enterprise-версия reCAPTCHA v3. Это определяется по подключению скрипта enterprise.js вместо api.js.

Важно:

• Токен действителен только для конкретного websiteURL и websiteKey
• Параметр minScore влияет на качество токена и время решения
• После получения токена необходимо проверить его на целевом сайте и отправить обратную связь в RuCaptcha

Подготовка окружения

Для работы потребуется:

• API-ключ из личного кабинета RuCaptcha
• HTTP-клиент для POST-запросов с JSON (curl, Postman, requests и т.д.)

Анализ страницы waze.com

Извлеките следующие параметры со страницы https://www.waze.com/live-map:

1. websiteKey — например 6Lf4WdUqAAAAAEUYUvzyLYIkO3PoFAqi8ZHGiDLW
   • Ищите в исходном коде по data-sitekey или в сетевых запросах по параметру k
2. websiteURL — https://www.waze.com/live-map
3. pageAction — часто не указан явно, используйте verify как значение по умолчанию
4. isEnterprise — установите true, так как Waze использует Enterprise-версию

Реализация

Шаг 1. Создание задачи

Отправьте POST-запрос на https://api.rucaptcha.com/createTask.

Пример запроса для Waze:

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "RecaptchaV3TaskProxyless",
        "websiteURL": "https://www.waze.com/live-map",
        "websiteKey": "6Lf4WdUqAAAAAEUYUvzyLYIkO3PoFAqi8ZHGiDLW",
        "minScore": 0.9,
        "pageAction": "verify",
        "isEnterprise": true
    }
}

Пример ответа:

{
    "errorId": 0,
    "taskId": 74455221488
}

Сохраните taskId для опроса результата.

Шаг 2. Опрос результата

Опрашивайте https://api.rucaptcha.com/getTaskResult.

Пример запроса:

{
    "clientKey": "YOUR_API_KEY",
    "taskId": 74455221488
}

Ответ при готовности:

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "gRecaptchaResponse": "03ADUVZwB7eLoqnBxvi5H...kA4Si3qH0rR0g"
    }
}

Ответ, если задача ещё не готова:

{
    "errorId": 0,
    "status": "processing"
}

Продолжайте опрос, пока status не станет ready.

Шаг 3. Использование токена в запросе к Waze

Добавьте полученный токен в параметр g-recaptcha-response при запросе к API Waze:

GET https://www.waze.com/live-map/api/georss?top=-26.54&bottom=-28.31&left=151.65&right=154.03&env=row&types=alerts,traffic&g-recaptcha-response=03ADUVZwB7eLoqnBxvi5H...kA4Si3qH0rR0g

Проанализируйте ответ:

• 200 ОК — токен принят, отправьте reportCorrect
• 403/429 — токен отклонён, отправьте reportIncorrect

Шаг 4. Обратная связь

Если Waze принял токен:

POST https://api.rucaptcha.com/reportCorrect

{
    "clientKey": "YOUR_API_KEY",
    "taskId": 74455221488
}

Если Waze отклонил токен:

POST https://api.rucaptcha.com/reportIncorrect

{
    "clientKey": "YOUR_API_KEY",
    "taskId": 74455221488
}

Отправка отчётов улучшает качество решений и позволяет возвращать средства за ошибочные токены.

Пояснения к параметрам

Типичные ошибки

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

• Документация по reCAPTCHA v3 API
• Метод reportIncorrect
• Метод reportCorrect
• Примеры кода на GitHub
• Поддержка RuCaptcha

Контрольный список

• Получен API-ключ из личного кабинета RuCaptcha
• Извлечены websiteKey и websiteURL со страницы Waze
• В задачу добавлен isEnterprise: true
• Установлен minScore: 0.3 (можно корректировать)
• Токен передаётся в запросе в параметре g-recaptcha-response
• Реализована отправка reportCorrect / reportIncorrect после проверки ответа Waze
• Настроено логирование для отладки

Заключение

Для обхода reCAPTCHA v3 Enterprise на Waze используйте задачу RecaptchaV3TaskProxyless с параметром isEnterprise: true и minScore: 0.3. После получения токена обязательно проверьте его на целевом эндпоинте и отправьте обратную связь в RuCaptcha.

Экспериментируйте с minScore, если задачи решаются слишком долго или часто отклоняются. Не забывайте про обработку ошибок и логирование — это обеспечит стабильную работу интеграции.