HCaptchaTask : решение капчи hCaptcha
Объект содержит данные о задаче на решение hCaptcha. Для обеспечения универсальности решения этого вида каптчи нам необходимо использовать все данные, которые Вы используете во время автоматизации заполнения формы на целевом сайте, включая прокси, user-agent браузера и cookies. Это позволит избежать любых проблем при изменении кода hCaptcha.
Каптча может решаться довольно долго по сравнению с обычной каптчей, но это компенсируется тем, что полученный g-captcha-response действует еще 60 секунд после решения каптчи.
Внимание!
hCaptcha ограничивает количество задач с одного IP адреса, примерно 3 штуки на 12 часов. Учитывайте это, когда будете строить систему решения через свои прокси, либо используйте режим без прокси, если это возможно.
Внимание!
Прокси с авторизацией по IP пока не поддерживаются.
Структура объекта
Параметр | Тип | Обязательный | Значение |
type | String | да | HCaptchaTask |
websiteURL | String | да | Адрес страницы на которой решается каптча |
websiteKey | String | да | Ключ-идентификатор hCaptcha на целевой странице. |
isInvisible | Bool | нет | true, если hCaptcha невидимая |
data | String | нет | Дополнительный параметр, используемый в основном с Важно: При передаче параметра обязательна передача |
proxyType | String | да | http - обычный http/https прокси |
proxyAddress | String | да | IP адрес прокси IPv4/IPv6. Не допускается:
|
proxyPort | Integer | да | Порт прокси |
proxyLogin | String | нет | Логин прокси-сервера |
proxyPassword | String | нет | Пароль прокси-сервера |
userAgent | String | нет | User-Agent браузера, используемый в эмуляции. Необходимо использовать подпись современного браузера, иначе Google будет возвращать ошибку, требуя обновить браузер. |
cookies | String | нет | Дополнительные cookies которые мы должны использовать во время взаимодействия с целевой страницей. Формат: cookiename1=cookievalue1; cookiename2=cookievalue2 |
Поддерживаемые типы
Поддерживаются следующие типы заданий:
|
|
|
|
|
|
Пример запроса
Адрес https://api.capmonster.cloud/createTask
{
"clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
"task":
{
"type":"HCaptchaTask",
"websiteURL":"https://lessons.zennolab.com/captchas/hcaptcha/?level=easy",
"websiteKey":"472fc7af-86a4-4382-9a49-ca9090474471",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36)",
"proxyType":"http",
"proxyAddress":"8.8.8.8",
"proxyPort":8080,
"proxyLogin":"proxyLoginHere",
"proxyPassword":"proxyPasswordHere"
}
}
Пример ответа
{
"errorId":0,
"taskId":407533072
}
Получение результата
Используйте метод getTaskResult чтобы получить решение hCaptcha. В зависимости от загрузки системы вы получите ответ через время в диапазоне от 10 с до 80 с.
Свойство | Тип | Описание |
gRecaptchaResponse | String | Хеш который необходимо подставить в форму с hCaptcha. |
userAgent | String | Необходимо использовать при сабмите тот же User Agent, c которым решалась hCaptcha. |
respKey | String | Результат функции "window.hcaptcha.getRespKey()" когда она доступна. Часть сайтов используют данное значение для дополнительной проверки. |
Пример:
{
"errorId":0,
"status":"ready",
"solution":
{
"gRecaptchaResponse": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.hKdwYXNza2V5xQb9JvlblBqjTdKpourvlRNpOZLvJb0yJRmsXVFVjyxFWlL1wdYBXaPyFtnxwy2ukbMgwWn62-cjSc98Iw2XIPYWg5MNDKS4_7tBIhjY0PienoKy1...",
"respKey": "E0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJkYXRhIjoidjQ3RjlqZGFYTllFQXlZZFYyRTlaWlBVQUdLaFpPakpRNjBXRTljVW40VnY3NnhuN2V3R0wwVWd1MW1Wai90WEdoYmt5a2NqVGlGdWpsSlpmVjcza...",
"userAgent": "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36"
}
}