가이드

hCaptcha 파라미터 찾기

이 페이지는 중국어 버전을 기계 번역한 것이라 부정확한 내용이 있을 수 있어요. 중국어 버전을 기준으로 해 주세요.

hCaptcha 작업을 만들려면 websiteURL(캡차가 나타나는 웹 페이지 주소)과 websiteKey(사이트 키, UUID 형식)가 필요해요. 엔터프라이즈 버전은 rqdata가 추가로 필요할 때도 있어요. 모두 브라우저 개발자 도구(F12)에서 찾을 수 있어요.

websiteKey

방법 1: 웹 페이지 소스 검색. Elements 패널에서 Ctrl+F(Mac은 Cmd+F)를 눌러 data-sitekey를 검색하세요.

<div class="h-captcha" data-sitekey="3ceb8624-1970-4e6b-91d5-70317b70b651"></div>

data-sitekey의 값이 websiteKey예요.

방법 2: 네트워크 요청 확인. Network 패널에서 hcaptcha를 검색해 checksiteconfig 요청을 찾으세요. 주소에서 sitekey= 뒤에 있는 값이 websiteKey예요.

https://api.hcaptcha.com/checksiteconfig?v=...&host=example.com&sitekey=51829642-2cda-4b09-896c-594f89d700cc&sc=1&swa=1

websiteURL

캡차가 나타나는 웹 페이지의 전체 주소를 입력하세요. hcaptcha.com이 아니에요. 위 요청의 host=가 바로 이 웹 페이지의 도메인이에요.

rqdata (엔터프라이즈 버전)

일부 웹사이트는 엔터프라이즈 버전 hCaptcha를 사용해요. 캡차를 불러올 때마다 웹사이트가 rqdata를 내려주고, 이 값을 보내지 않으면 통과할 수 없어요. 보통 웹사이트 자체 API의 응답(예: 로그인 API가 반환하는 captcha_rqdata)에 들어 있거나, hcaptcha.render / hcaptcha.setData를 호출할 때 전달돼요. 값을 얻으면 작업의 rqdata 필드에 넣으세요. rqdata는 보통 한 번만 사용할 수 있으므로 매번 새로 가져와야 해요.

userAgent

userAgent에는 /useragent가 반환한 값만 사용할 수 있어요. token을 제출할 때는 인식 결과에 반환된 userAgent를 사용하세요.