solvethree에서 첫 CAPTCHA 해결하기

1. 1.

   가입 및 워크스페이스 설정하기

   가입부터 시작하세요. API 키, 사이트 프로필, 크레딧에 동일한 워크스페이스를 사용하세요.

2. 2.

   키 생성하기

   콘솔에서 API 키를 여세요. API 키 생성을 선택하고 키 이름을 입력한 뒤 키 생성을 선택하세요.

3. 3.

   비밀 키 저장하기

   API 키 저장 아래에 표시된 비밀 키를 복사하고 안전하게 보관한 뒤 이 키를 저장했습니다를 선택하세요. 접두사 표시로는 나중에 전체 비밀 키를 복구할 수 없습니다. 키는 브라우저 코드가 아닌 서버에 보관하세요.

가입 크레딧은 $5입니다. 자금을 추가해야 한다면 최소 입금액은 $10입니다. reCAPTCHA 요금은 해결 작업 1,000건당 $2.00입니다. ready 상태의 작업에는 요금이 부과되며, 실패한 해결 작업은 환불됩니다.

1. 1.

   대상 페이지 추가하기

   사이트 프로필을 열고 사이트 추가를 선택하세요. 대상의 HTTPS 페이지 URL을 입력하고 Enterprise v3를 선택하세요.

2. 2.

   캡처 액션 설정하기

   연동하려는 작업에 필요한 액션을 사용하세요. 아래 요청 예제는 login을 사용하므로 대상의 실제 액션이 login인 경우에만 사용하세요. 호스트 이름, 캡처 액션, reCAPTCHA 유형의 조합마다 프로필 하나를 추가하세요.

3. 3.

   활성 상태가 될 때까지 기다리기

   사이트 추가를 선택하세요. 일부 계정에는 먼저 계속하려면 크레딧 추가가 표시됩니다. 제출 내용에 따라 프로필이 캡처, 검증 또는 검토 상태를 거칠 수 있습니다. 활성 상태가 된 후에만 계속하세요. 캡처 소요 시간은 보장되지 않습니다. 캡처에 실패하면 다시 시도하기 전에 사유를 확인하세요.

작업에 호스트 이름과 액션을 전송해도 프로필은 생성되지 않습니다. 첫 해결 작업에는 프로필의 캡처 액션을 정확히 그대로 사용하세요. 선택적 필드와 액션 선택은 사이트 프로필 설정을 참고하세요.

다음 본문을 POST https://api.solvethree.com/v1/tasks로 보내세요. Authorization 헤더에 Bearer 뒤로 워크스페이스 API 키를 붙여 인증하세요.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site를 전체 페이지 URL이 아닌 대상 호스트 이름으로 바꾸세요. action을 첫 해결 작업에 선택한 액션으로 바꾸세요.
• proxy를 HTTP 프록시 URL과 자격 증명으로 바꾸세요. 이 요청은 프록시 하나를 사용하므로 proxyCandidates를 함께 보내지 마세요.
• 이 논리적 요청에 사용할 requestId를 선택하고 제출한 입력과 함께 보관하세요. ASCII 영문자, 숫자, 밑줄 또는 하이픈으로 구성된 1–64자를 사용할 수 있습니다.
• type과 url은 제외하세요. recaptchaType을 생략하면 요청은 기본적으로 Enterprise v3를 사용합니다.

완전한 Python 구현은 Python에서 reCAPTCHA Enterprise 사용하기를 참고하세요. 여기의 요청은 먼저 준비해야 할 값을 보여줍니다.

생성 시 반환된 작업 ID를 보관하세요. GET https://api.solvethree.com/v1/tasks/:id에서 :id를 해당 ID로 바꾸고 동일한 Bearer 인증을 사용해 조회하세요.

• 본문을 성공한 작업 응답으로 읽기 전에 HTTP 응답이 성공인지 확인하세요.
• 상태가 pending 또는 solving이면 폴링을 계속하세요. 두 상태 모두 사용할 수 있는 솔루션을 포함하지 않습니다.
• 상태가 ready이면 폴링을 중지하고 solution을 읽으세요.
• 상태가 failed이면 폴링을 중지하고 errorCode와 error를 살펴보세요. 실패한 해결 작업은 환불됩니다.

ready 응답의 구조는 다음과 같습니다. 이 토큰과 브라우저 식별 정보 값은 예시용 값이며 실제로 사용할 수 있는 솔루션이 아닙니다.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   작업 ID가 아닌 토큰 보내기

   대상이 reCAPTCHA 토큰을 받도록 지정한 위치에 solution.token을 넣으세요. 전송 요청을 살펴보고 작업 ID나 오래된 토큰을 보내고 있지 않은지 확인하세요.

2. 2.

   반환된 브라우저 식별 정보 사용하기

   대상 요청에 solution.userAgent와 solution.secChUa를 사용하고, 이 해결 작업에 제공한 것과 동일한 프록시를 함께 사용하세요. 관련 없는 브라우저 식별 정보와 섞어 사용하거나 다른 대상 URL에 토큰을 제출하지 마세요.

3. 3.

   대상의 응답 확인하기

   대상이 의도한 작업을 수락했는지 확인하세요. ready 상태의 작업은 solvethree가 솔루션을 생성했다는 뜻이며, 대상이 후속 요청을 수락한다는 보장은 아닙니다.

일괄 작업을 시작하기 전에 이 단일 요청이 대상에서 수락되도록 하세요. 거부되면 해결 작업을 추가 구매하기 전에 제출한 토큰, 브라우저 식별 정보, 프록시, 대상 URL을 확인하세요.