API로 표준 reCAPTCHA v3 해결하기

일반 v3에서도 워크스페이스에서 사용할 수 있는 활성 사이트 프로필이 필요합니다. 작업을 생성하기 전에 콘솔에서 대상 사이트를 설정하세요. 호스트 이름과 액션을 전송하는 것만으로는 프로필이 생성되지 않습니다.

• site: 전체 페이지 URL이 아닌 accounts.example.com 같은 대상 호스트 이름입니다.
• action: 대상의 reCAPTCHA 통합에서 사용하는 액션입니다. 대상이 다른 액션을 사용한다면 예제의 login을 바꾸세요. 액션을 찾는 방법을 참고하세요.
• proxy 또는 proxyCandidates: 둘 중 정확히 하나만 제공하세요. 예제는 단일 프록시를 사용합니다. 대신 후보 목록을 사용한다면 경로, 쿼리, 프래그먼트가 없는 서로 다른 HTTP 또는 HTTPS 프록시 URL을 최대 열두 개까지 지정할 수 있습니다.

이 JSON 본문을 POST https://api.solvethree.com/v1/tasks로 보내세요. Authorization 헤더에 Bearer 스킴으로 워크스페이스 API 키를 넣어 인증하세요. 키는 서버에 보관하세요.

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

recaptchaType은 site, action, proxy와 함께 최상위 수준에 있어야 합니다. reCAPTCHA에서는 type이나 url 필드를 추가하지 마세요.

예제의 호스트 이름, 액션, 프록시를 대상의 값으로 바꾸세요. 새로운 논리적 해결 작업마다 새 requestId를 사용하세요. 생성 요청이 시간 초과되면 동일한 ID와 작업 본문을 다시 보내 새 작업을 생성하는 대신 기존 작업을 복구하세요. 해당 ID를 다른 입력값과 함께 재사용하면 충돌이 발생합니다.

1. 1.

   먼저 HTTP 응답 확인

   본문을 작업 결과로 읽기 전에 성공이 아닌 HTTP 응답을 처리하세요. 상태를 확인하고 보고된 요청 오류를 수정하세요.

2. 2.

   완료될 때까지 작업 조회

   생성 요청은 기본적으로 최대 15초 동안 대기합니다. 클라이언트의 시간 제한에는 네트워크 오버헤드를 고려한 여유 시간을 두세요. 상태가 pending 또는 solving이면 GET /v1/tasks/:id로 작업을 조회하세요. GET 폴링은 기본적으로 대기하지 않습니다. 롱 폴링을 사용하려면 JSON 필드가 아닌 URL 쿼리 매개변수로 waitMs를 최대 15000까지 전달하세요. ready 또는 failed 상태가 되면 폴링을 중단하세요. failed인 경우, 다시 시도할지 판단하기 전에 errorCode와 error를 확인하세요.

3. 3.

   준비된 솔루션 사용

   작업 ID가 아닌 solution.token을 의도한 대상에 제출하세요. 반환된 userAgent와 secChUa를 해결에 성공한 프록시와 함께 사용하세요. 해결과 제출 사이에 IP를 바꾸거나 관련 없는 브라우저 식별 정보로 대체하지 마세요.

준비된 토큰이 특정 reCAPTCHA 점수나 대상의 수락을 보장하지는 않습니다. reCAPTCHA v3는 대상이 백엔드에서 평가하는 위험 점수와 액션을 생성합니다. 토큰을 제출한 요청에 대한 대상의 응답을 확인하세요.