Распознавание, автоматическое решение и обход reCAPTCHA v3

Как решать reCAPTCHA V3 с помощью нашего сервиса:

1. В первую очередь нужно убедиться, что на сайте действительно используется reCAPTCHA V3.

   Основные признаки V3:

   • не видна пользователю, не требует кликать по картинкам;
   • скрипт api.js загружается с параметром render=sitekey, например:
     https://www.google.com/recaptcha/api.js?render=6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE
   • в массиве clients конфигурационного объекта ___grecaptcha_cfg используется индекс 100000: ___grecaptcha_cfg.clients[100000]

2. Для решения V3 через наш API необходимо найти значения трех параметров:

   sitekey - его можно найти в html в значении параметра render при загрузке api.js, в параметре k в URI iframe, в который подгружается reCAPTCHA, либо в javscript, в вызове функции grecaptcha.execute или в конфигурационном объекте ___grecaptcha_cfg.

   action - это значение нужно искать в javascript коде сайта в вызове функции grecaptcha.execute. Пример: grecaptcha.execute('6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE', {action: do_something}).
   Иногда найти его достаточно сложно и требуется перевернуть вверх дном все js-файлы, подгружаемые сайтом. Кроме того, можно попробовать найти значение action в конфигурационном объекте ___grecaptcha_cfg, но очень часто оно может быть не задано там, а передаваться только при вызове grecaptcha.execute - поэтому наиболее эффективный метод - просмотр javascript кода.

   pageurl - полный URL страницы, где вы хотите решить reCAPTCHA V3.

   Кроме того, нужно понять, какое значение score вам требуется. Определить извне, при каком score сайт решит, что вы человек и пропустит ваш запрос, можно только экспериментально. Самый низкий рейгинг 0.1 - робот, а самый высокий 0.9 - человек. Но, многие сайты ставят пороговые значения от 0.2 до 0.5, т.к. обычный человек зачастую получает довольно низкий рейтинг. С наибольшей вероятностью от нашего API можно получить score 0.3, более высокие значения score у работников встречаются довольно редко.

3. Имея все необходимые параметры, можно отправлять запрос к нашему API.

4. Отправьте запрос HTTP GET или POST к нашему API:
   http://api.solvecaptcha.com/in.php
   с персональным ключом API и параметром method, соответствующим виду капчи, в данном случае — userrecaptcha, в параметре version нужно указать v3, в параметре min_score - требуемое значение score. Также укажите значения, найденные на предыдущем шаге: sitekey укажите в параметре googlekey, полный URL страницы, на которой вы хотите решить reCAPTCHA в параметре pageurl, значение action - в одноименном параметре action, если его не указать мы будем использовать значение по умолчанию - verify.

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

   http://api.solvecaptcha.com/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=userrecaptcha&version=v3&action=verify&min_score=0.3
                   &googlekey=6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE&pageurl=http://mysite.com/page/

5. Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON {"status":1,"request":"2122988149"} если вы использовали параметр json в запросе.

   Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

6. Подождите 10-15 секунд и отправьте HTTP GET запрос к нашему API: http://api.solvecaptcha.com/res.php с чтобы получить результат по ID вашей капчи.
   Полный список параметров запроса можно найти в таблице ниже.

   Если ваша капча уже решена, то сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

   03AHJ_Vuve5Asa4koK3KSMyUkCq0vUFCR5Im4CwB7PzO3dCxIo11i53epEraq-uBO5mVm2XRikL8iKOWr0aG50sCuej9bXx5qcviUGSm4iK4NC_Q88flavWhaTXSh0VxoihBwBjXxwXuJZ-WGN5Sy4dtUl2wbpMqAj8Zwup1vyCaQJWFvRjYGWJ_TQBKTXNB5CCOgncqLetmJ6B6Cos7qoQyaB8ZzBOTGf5KSP6e-K9niYs772f53Oof6aJeSUDNjiKG9gN3FTrdwKwdnAwEYX-F37sI_vLB1Zs8NQo0PObHYy0b0sf7WSLkzzcIgW9GR0FwcCCm1P8lB--gf50q5BMkiRH7osm4DoUgsjc_XyQiEmQmxl5sqZP7aKsaE-EM00x59XsPzD3m3YI6SRCFRUevSyumBd7KmXE8VuzIO9lgnnbka4-eZynZa6vbB9cO3QjLH0xSG3--o-fxrOuphwfrtwvvi2FGfpTexWvxhqWICMFTTjFBCEGEgj7_IFWEKirXW2RTZCVF0Gid7EtIsoEeZkPbrcUISGmgtiJkJ_KojuKwImF0G0CsTlxYTOU2sPsd5o1JDt65wGniQR2IZufnPbbK76Yh_KI2DY4cUxMfcb2fAXcFMc9dcpHg6f9wBXhUtFYTu6pi5LhhGuhpkiGcv6vWYNxMrpWJW_pV7q8mPilwkAP-zw5MJxkgijl2wDMpM-UUQ_k37FVtf-ndbQAIPG7S469doZMmb5IZYgvcB4ojqCW3Vz6Q

   Если ваша капча ещё не решена, то сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

   Если что-то пошло не так, сервер вернёт код ошибки.

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

   http://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&json=1&id=2122988149

7. После получения токена от нашего API, нужно корректно использовать его на сайте. Лучший метод понять, как это сделать - посмотреть на то, какие запросы отправляются на сайт, когда вы работаете с ним как обычный посетитель. Большинство браузеров позволяют легко это сделать в консоли разработчика, нужная вкладка обычно называется "Network".

   Токен обычно отправляется в параметрах POST-запроса, это может быть g-recaptcha-response как у reCAPTCHA V2, g-recaptcha-response-100000 или какой-либо другой параметр. Поэтому нужно внимательно просмотреть параметры запроса и найти, как именно передается токен, а затем сформировать аналогичный запрос.

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

   Чтобы сообщить о том, сработал токен или нет - отправьте запрос к http://api.solvecaptcha.com/res.php с вашим ключем API в параметре key, id капчи в одноименном параметре id и указав в параметре action, в зависимости от результата: reportgood - токен сработал или reportbad - токен не сработал.

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

   ReportBAD

   http://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=reportbad&id=2122988149

   ReportGOOD

   http://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=reportgood&id=2122988149

   Важное замечание: в интерфейсе на сайте не отображаются жалобы на любые виды капч с токеном, в том числе reCAPTCHA V3. Мы обрабатываем каждый такой запрос, но пока не придумали адекватный интерфейс для подобных жалоб. В будущем постараемся это сделать.

Список параметров для GET/POST запросов к http://api.solvecaptcha.com/in.php

Параметр	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
method	Строка	Да	userrecaptcha — определяет, что вы решаете reCAPTCHA
version	Строка	Да	v3 — указывает на то, что это reCAPTCHA V3
googlekey	Строка	Да	Значение параметра sitekey, которое вы нашли в коде сайта
pageurl	Строка	Да	Полный URL страницы, на которой вы решаете reCAPTCHA V2
domain	Строка По умолчанию: google.com	Нет	Домен, с которого загружается reCAPTCHA: recaptcha.net или google.com
action	Строка По умолчанию: verify	Нет	Значение параметра action, которые вы нашли в коде сайта
min_score	Число По умолчанию: 0.4	Нет	Требуемое значение рейтинга (score). На текущий момент сложно получить токен со score выше 0.3
header_acao	Число По умолчанию: 0	Нет	0 — выключен 1 — включен Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ. Используется для кроссдоменных AJAX-запросов из веб-приложений.
pingback	Строка	Нет	URL для автоматической отправки ответа на капчу (callback). URL должен быть зарегистрирован на сервере. Больше информации здесь.
json	Число По умолчанию: 0	Нет	0 — сервер вернёт ответ в виде простого текста 1 — сервер вернёт ответ в формате JSON
soft_id	Число	Нет	ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://api.solvecaptcha.com/res.php

GET параметр	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
action	Строка	Да	get — получить ответ на капчу reportgood — - сообщить о том, что токен сработал reportbad — - сообщить о том, что токен не сработал
id	Число	Да	ID капчи, полученный от in.php.
json	Число По умолчанию: 0	Нет	0 — сервер вернёт ответ в виде простого текста 1 — сервер вернёт ответ в формате JSON
header_acao	Число По умолчанию: 0	Нет	0 — выключен 1 — включен Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ. Используется для кроссдоменных AJAX-запросов из веб-приложений.