HCaptchaTask
Объект содержит данные о задаче на решение hCaptcha. Для обеспечения универсальности решения этого вида каптчи нам необходимо использовать все данные, которые Вы используете во время автоматизации заполнения формы на целевом сайте, включая прокси, user-agent браузера и cookies. Это позволит избежать любых проблем при изменении кода hCaptcha.
Каптча может решаться довольно долго по сравнению с обычной каптчей, но это компенсируется тем, что полученный g-captcha-response действует еще 60 секунд после решения каптчи.
hCaptcha ограничивает количество задач с одного IP адреса, примерно 3 штуки на 12 часов. Учитывайте это, когда будете строить систему решения через свои прокси, либо используйте режим без прокси, если это возможно.
Прокси с авторизацией по IP пока не поддерживаются.
Структура объекта
| Параметр | Тип | Обязательный | Значение |
|---|---|---|---|
| type | String | да | HCaptchaTaskProxyless или HCaptchaTask (При использовании прокси). |
| websiteURL | String | да | Адрес страницы на которой решается капча. |
| websiteKey | String | да | Ключ-идентификатор hCaptcha на целевой странице. |
| isInvisible | Bool | нет | true, если hCaptcha невидимая. |
| data | String | нет | Дополнительный параметр, используемый в основном с Важно: При передаче параметра обязательна передача |
| proxyType | String | да (При использовании HCaptchaTask) | http - обычный http/https прокси https - попробуйте эту опцию только если "http" не работает (требуется для некоторых кастомных прокси) socks4 - socks4 прокси socks5 - socks5 прокси |
| proxyAddress | String | да (При использовании HCaptchaTask) | IP адрес прокси IPv4/IPv6. Не допускается: - использование имен хостов - использование прозрачных прокси (там где можно видеть IP клиента) - использование прокси на локальных машинах |
| proxyPort | Integer | да (При использовании HCaptchaTask) | Порт прокси |
| proxyLogin | String | нет | Логин прокси-сервера |
| proxyPassword | String | нет | Пароль прокси-сервера |
| userAgent | String | нет | User-Agent браузера, используемый в эмуляции. Необходимо использовать подпись современного браузера, иначе Google будет возвращать ошибку, требуя обновить браузер. Передавайте только актуальный UA от ОС Windows. Сейчас таковым является 120 версия: “Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36” |
| cookies | String | нет | Дополнительные cookies которые мы должны использовать во время взаимодействия с целевой страницей. Формат: cookiename1=cookievalue1; cookiename2=cookievalue2 |
| fallbackToActualUA | Bool | нет | true - при указании данного параметра мы игнорируем неактуальный User Agent, который отправляют в запросе пользователи, и возвращаем с getTaskResult свой (актуальный). Это позволит улучшить принимаемость токенов. false - мы подставляем User Agent, который указан в запросе. Если User Agent неактуален, то получите ошибку ERROR_WRONG_USERAGENT (USERAGENT IS EXPIRED в логе). |
Поддерживаемые типы
Поддерживаются следующие типы заданий:
 |  |
|---|---|
 |  |
 |  |
 |
Пример запроса
<https://api.capmonster.cloud/createTask>
HCaptchaTask (С использованием прокси)
{
"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",
"fallbackToActualUA":true,
"proxyType":"http",
"proxyAddress":"8.8.8.8",
"proxyPort":8080,
"proxyLogin":"proxyLoginHere",
"proxyPassword":"proxyPasswordHere"
}
}
HCaptchaTaskProxyless (Без использования прокси)
{
"clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
"task":
{
"type":"HCaptchaTaskProxyless",
"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",
"fallbackToActualUA":true
}
}
Пример ответа
{
"errorId":0,
"taskId":407533072
}
Получение результата
<https://api.capmonster.cloud/getTaskResult>
Используйте метод 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/120.0.0.0 Safari/537.36"
}
}