HCaptchaTaskProxyless : решение каптчи hCaptcha

Объект содержит данные о задаче на решение hCaptcha. Такая задача будет выполняться нашим сервисом с использованием наших собственных прокси-серверов.

Структура объекта

Параметр	Тип	Обязательный	Значение
type	String	да	HCaptchaTaskProxyless
websiteURL	String	да	Адрес страницы на которой решается каптча
websiteKey	String	да	Ключ-идентификатор hCaptcha на целевой странице.
isInvisible	Bool	нет	true, если hCaptcha невидимая
data	String	нет	Дополнительный параметр, используемый в основном с `isInvisible=true`. Важно: При передаче параметра обязательна передача `userAgent`. Значение, которое передается в `userAgent`, должно соответствовать тому, которое используется для сабмита токена Передавайте только актуальный 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”
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

{
    "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
}

Получение результата

Используйте метод 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/119.0.0.0 Safari/537.36"
    }
}