Меню документации

HCaptchaTask: решить HCaptcha через прокси

Разработчики hCaptcha называют свою капчу "a drop-in replacement for Recaptcha". Мы применили тот же принцип в нашем API, поэтому свойства в API те же самые, как и в RecaptchaV2Task, кроме свойства "type".

ВАЖНО: hCaptcha похоже ограничивает количество решенных задач с одного IP, около 3 штук на каждые 12. Имейте это ввиду, когда будете строить процесс решения через свои прокси.

пример Recaptcha V2

Объект задачи

Свойство Тип Требуется Назначение
type Строка Да HCaptchaTask
websiteURL Строка Да Адрес целевой страницы. Может находиться в любом месте сайта, в том числе в закрытом для подписчиков разделе. Наши работники не посещают сайт, а вместо этого эмулируют посещение страницы.
websiteKey Строка Да ключ сайта hCaptcha
proxyType Строка Да Тип прокси
http - обычный http/https прокси
socks4 - socks4 прокси
socks5 - socks5 прокси
proxyAddress Строка Да Адрес прокси в ipv4/ipv6. Имена хостов или адреса из локальной сети не допускаются.
proxyPort Integer Да Порт прокси
proxyLogin Строка Нет Логин если требуется авторизация прокси (basic)
proxyPassword Строка Нет Пароль прокси
userAgent Строка Да User-Agent браузера, который нужно эмулировать. Требуется указывать юзерагент современного браузера, иначе гугл попросит "обновить ваш браузер".

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

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"HCaptchaTask",
            "websiteURL":"https://hcaptcha.com/",
            "websiteKey":"00000000-0000-0000-0000-000000000000",
            "proxyType":"http",
            "proxyAddress":"8.8.8.8",
            "proxyPort":8080,
            "proxyLogin":"proxyLoginHere",
            "proxyPassword":"proxyPasswordHere",
            "userAgent":"MODERN_USER_AGENT_HERE"
        }
}' https://api.anti-captcha.com/createTask
        

Пример ответа

JSON без ошибок
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON с ошибками
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

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

Используйте метод getTaskResult чтобы получить результат. Дайте работнику некоторое время перед первым запросом, около 5 секунд. Если работник все еще занят, повторите запрос через 3 секунды.

Объект решения задачи

Свойство Тип Назначение
gRecaptchaResponse Строка Строка токена, которая требуется для отправки формы на целевом сайте.

Пример ответа

JSON без ошибок
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}