문서 메뉴

HCaptchaTask: 프록시를 통해 H캡챠를 푸세요.

h캡챠 개발자가 본인의 캡챠를 "a drop-in replacement for Recaptcha"라고 부릅니다. 저희는 API에서 동일한 걸 생성하려 하였으므로, 태스크 프로퍼티가 RecaptchaV2Task와(과) 완전히 동일합니다(단, "유형" 프로퍼티 예외).

중요: H캡챠는 하나의 IP에서 풀린 태스크의 한도가 있는 것 같습ㄴ다. 12시간당 약 3개의 항목이 있습니다. 프록시를 통해서 캡챠 푸는 과정을 구축할 때 이 점을 고려하세요.

리캡챠 V2 예시

태스크 객체

프로퍼티 유형 필수 목적
type 스트링 HCaptchaTask
websiteURL 스트링 타겟 웹페이지 주소. 웹사이트의 어디에든지, 심지어 고객 페이지에도 위치할 수 있습니다. 저희 작업자는 이 부분을 다루지 않지만, 대신에 이 페이지 방문을 시뮬레이션합니다.
websiteKey 스트링 H캡챠 사이트키
proxyType 스트링 프록시 유형
http - 일반 http/https proxy
socks4 - socks4 proxy
socks5 - socks5 proxy
proxyAddress 스트링 프록시 IP 주소 ipv4/ipv6. 로컬 네트워크의 호스트명 혹은 IP 주소 없음
proxyPort 정수 프록시 포트
proxyLogin 스트링 아니요 승인이 필요한 프록시 로그인(기본)
proxyPassword 스트링 아니요 프록시 비밀번호
userAgent 스트링 에뮬레이션에 이용되는 브라우저의 사용자 에이전트. 최신 브라우저의 서명을 이용해야 합니다. 그렇지 않으면, 구글에서 "update your browser"를 요청할 것입니다.

예시 요청

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