solvethree가 websiteKey 필드 대신 사이트 프로필을 사용하는 이유

1. 1.

   '사이트 추가' 열기

   사이트 프로필로 이동해 사이트 추가를 선택하세요. 대상의 HTTPS 페이지 URL을 입력하세요. 작업에는 이 전체 URL이 아닌 호스트 이름이 사용됩니다. 페이지 설정에 필요한 경우 선택 항목인 탐색 URL과 Referer 값을 입력하세요.

2. 2.

   유형 선택 및 사이트 키 확인

   reCAPTCHA Enterprise 연동에는 Enterprise v3를, 일반 reCAPTCHA v3에는 Regular v3를 선택하세요. 양식에서 사이트 키를 자동으로 찾을 수 있으며, 선택 항목인 사이트 키 필드에 재정의할 값을 입력할 수도 있습니다.

3. 3.

   캡처 액션 설정

   캡처 액션은 필수입니다. 아래 요청을 사용하려면 캡처 액션이 login인 프로필을 설정하세요. 검토된 시스템 프로필은 실시간으로 가져오지 않고도 알려진 페이지 설정과 캡처 액션을 채울 수 있습니다. 선택한 액션에 대한 양식의 설명을 읽어보세요.

4. 4.

   제출 후 활성화 대기

   사이트 추가를 선택하세요. 제출한 프로필은 활성화되기 전에 대기, 캡처, 검증 또는 검토 상태를 거칠 수 있으며, 캡처에 걸리는 시간은 보장되지 않습니다. 일부 계정에는 계속하려면 크레딧 추가가 표시됩니다. 캡처에 실패하면 재시도하기 전에 원인을 확인하세요.

호스트 이름, 캡처 액션, reCAPTCHA 유형의 조합마다 프로필 하나를 사용하세요. 실행 액션이 정확히 일치하면 해당 프로필이 선택됩니다. 다른 실행 액션에는 명확하게 하나로 정해지는 캡처 대상이 필요하므로, 호스트 이름에 대한 프로필 하나가 모든 액션을 처리한다고 가정하지 마세요.

프로필이 활성화되면 이 객체를 JSON 본문으로 POST /v1/tasks에 직접 전송하세요. Authorization: Bearer 뒤에 워크스페이스 API 키를 넣어 인증하고, 해당 키는 서버에 보관하세요.

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

• site는 호스트 이름이며 스킴, 경로, 쿼리를 포함하지 않습니다. 전체 페이지 URL은 콘솔 프로필에 입력해야 합니다.
• action은 이 작업의 실행 액션입니다. 여기서 login은 위에서 설정한 캡처 액션과 일치합니다.
• proxy는 풀이에 사용할 프록시를 지정합니다. proxy와 proxyCandidates 중 정확히 하나가 필요하며, 둘 다 전송하면 안 됩니다.
• requestId는 선택 사항입니다. 생성 요청이 시간 초과되면 동일한 ID로 같은 요청을 다시 전송할 때 기존 작업이 반환됩니다. 해당 ID를 재사용하면서 작업 입력을 변경하면 충돌이 발생합니다.

이전 API의 요청 구조에서 websiteKey, websiteURL, type 또는 url을 그대로 가져오지 마세요. reCAPTCHA에서 recaptchaType의 기본값은 enterprise-v3이므로 예제에서는 생략했습니다. 일반 v3는 recaptchaType을 v3로 설정합니다.