Эта статья была полезной?
Как решить reCAPTCHA v3 Enterprise на сайте waze.com
Технический специалист
Введение
Это руководство описывает интеграцию с 2Captcha для обхода 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влияет на качество токена и время решения - После получения токена необходимо проверить его на целевом сайте и отправить обратную связь в 2Captcha
Подготовка окружения
Для работы потребуется:
- API-ключ из личного кабинета 2Captcha
- HTTP-клиент для POST-запросов с JSON (curl, Postman, requests и т.д.)
Анализ страницы waze.com
Извлеките следующие параметры со страницы https://www.waze.com/live-map:
- websiteKey — например
6Lf4WdUqAAAAAEUYUvzyLYIkO3PoFAqi8ZHGiDLW- Ищите в исходном коде по
data-sitekeyили в сетевых запросах по параметруk
- Ищите в исходном коде по
- websiteURL —
https://www.waze.com/live-map - pageAction — часто не указан явно, используйте
verifyкак значение по умолчанию - isEnterprise — установите
true, так как Waze использует Enterprise-версию
Реализация
Шаг 1. Создание задачи
Отправьте POST-запрос на https://api.2captcha.com/createTask.
Пример запроса для Waze:
json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://www.waze.com/live-map",
"websiteKey": "6Lf4WdUqAAAAAEUYUvzyLYIkO3PoFAqi8ZHGiDLW",
"minScore": 0.9,
"pageAction": "verify",
"isEnterprise": true
}
}
Пример ответа:
json
{
"errorId": 0,
"taskId": 74455221488
}
Сохраните taskId для опроса результата.
Шаг 2. Опрос результата
Опрашивайте https://api.2captcha.com/getTaskResult.
Пример запроса:
json
{
"clientKey": "YOUR_API_KEY",
"taskId": 74455221488
}
Ответ при готовности:
json
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "03ADUVZwB7eLoqnBxvi5H...kA4Si3qH0rR0g"
}
}
Ответ, если задача ещё не готова:
json
{
"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 принял токен:
json
POST https://api.2captcha.com/reportCorrect
{
"clientKey": "YOUR_API_KEY",
"taskId": 74455221488
}
Если Waze отклонил токен:
json
POST https://api.2captcha.com/reportIncorrect
{
"clientKey": "YOUR_API_KEY",
"taskId": 74455221488
}
Отправка отчётов улучшает качество решений и позволяет возвращать средства за ошибочные токены.
Пояснения к параметрам
| Параметр | Значение для Waze | Примечание |
|---|---|---|
type |
RecaptchaV3TaskProxyless |
Используйте Proxyless, так как использование прокси с этим типом капчи ухудшает minScore |
websiteURL |
https://www.waze.com/live-map |
Должен точно совпадать с адресом, где загружается капча |
websiteKey |
Из исходного кода страницы | Меняется редко, но периодически проверяйте |
minScore |
0.3 |
Начните с низкого значения и при необходимости изменяйте его |
pageAction |
verify |
Если не указан на странице явно, попробуйте вовсе его не отправлять |
isEnterprise |
true |
Обязательно для Waze |
Типичные ошибки
| Ошибка | Причина | Решение |
|---|---|---|
ERROR_WRONG_USER_KEY |
Неверный API-ключ | Проверьте ключ в личном кабинете 2Captcha |
ERROR_NO_SLOT_AVAILABLE |
Высокая нагрузка | Повторите запрос через 10–30 секунд |
ERROR_ZERO_BALANCE |
Недостаточно средств | Пополните баланс |
| Токен отклоняется (403) | Низкий score или неверный action | Увеличьте minScore до 0.9, проверьте pageAction |
isEnterprise не указан |
Waze требует Enterprise-версию | Добавьте "isEnterprise": true |
| Злоупотребление reportIncorrect | Много жалоб при низкой конверсии | Проверьте логику валидации токена перед отправкой отчётов |
Дополнительные ресурсы
- Документация по reCAPTCHA v3 API
- Метод reportIncorrect
- Метод reportCorrect
- Примеры кода на GitHub
- Поддержка 2Captcha
Контрольный список
- Получен API-ключ из личного кабинета 2Captcha
- Извлечены
websiteKeyиwebsiteURLсо страницы Waze - В задачу добавлен
isEnterprise: true - Установлен
minScore: 0.3(можно корректировать) - Токен передаётся в запросе в параметре
g-recaptcha-response - Реализована отправка
reportCorrect/reportIncorrectпосле проверки ответа Waze - Настроено логирование для отладки
Заключение
Для обхода reCAPTCHA v3 Enterprise на Waze используйте задачу RecaptchaV3TaskProxyless с параметром isEnterprise: true и minScore: 0.3. После получения токена обязательно проверьте его на целевом эндпоинте и отправьте обратную связь в 2Captcha.
Экспериментируйте с minScore, если задачи решаются слишком долго или часто отклоняются. Не забывайте про обработку ошибок и логирование — это обеспечит стабильную работу интеграции.