Menu dokumentacja

HCaptchaTask: rozwiązywanie HCaptcha przez proxy

Twórcy hCaptcha deklarują, że ich captcha jest "kompatybilnym zamiennikiem dla Recaptcha". Spróbowaliśmy stworzyć to samo w naszym API, więc atrybuty zadań są dokładnie takie same jak przy RecaptchaV2Task oprócz atrybutu "type".

WAŻNE: hCaptcha wydaje się nakładać limit na rozwiązane zadania z jednego IP, około 3 zadań na 12 godzin. Należy brać to pod uwagę tworząc rozwiązania korzystające z własnego proxy.

Recaptcha V2 przykład

Obiekt zadanie

Właściwość/atrybut Typ Wymagany Przeznaczenie
type Łańcuch znaków (String) Tak HCaptchaTask
websiteURL Łańcuch znaków (String) Tak Adres docelowej strony. Może wskazywać na dowolną lokalizację w ramach witryny, włącznie ze strefami dla zalogowanych. Nasi pracownicy nie muszą tam wchodzić, gdyż wizyta jest symulowana.
websiteKey Łańcuch znaków (String) Tak klucz strony hCaptcha
proxyType Łańcuch znaków (String) Tak Typ proxy
http - zwyczajne proxy http/https
socks4 - proxy socks4
socks5 - proxy socks5
proxyAddress Łańcuch znaków (String) Tak Adres ipv4/ipv6 proxy. Nie stosować nazw hostów ani adresów IP z sieci lokalnych.
proxyPort Integer Tak Port proxy
proxyLogin Łańcuch znaków (String) Nie Login dla proxy wymagających uwierzytelniania (podstawowe)
proxyPassword Łańcuch znaków (String) Nie Hasło proxy
userAgent Łańcuch znaków (String) Tak Informacja User-Agent o przeglądarce, stosowana przy emulacji. Wymagane jest podanie sygnatury nowoczesnej przeglądarki, w przeciwnym razie Google każe "zaktualizować przeglądarkę".

Przykład żądania

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
        

Przykład odpowiedzi

JSON bez błędów
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON z błędem
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

Odbierz rozwiązanie

Skorzystaj z metody getTaskResult by odebrać rozwiązanie. Daj pracownikowi trochę czasu, na przykład 5 sekund, zanim prześlesz pierwszą prośbę odbioru. Jeśli pracownik nadal jest zajęty, powtórz próbę po 3 sekundach.

Obiekt rozwiązanie zadania

Właściwość/atrybut Typ Przeznaczenie
gRecaptchaResponse Łańcuch znaków (String) Łańcuch znaków token wymagany do interakcji z formularzem wysyłania na docelowej stronie.

Przykład odpowiedzi

JSON bez błędów
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}