Cloudbypass API 자주 묻는 질문
요금제 포인트는 어떻게 차감되나요?
Cloudflare와 DataDome은 하나의 API 크레딧 잔액과 동일한 차감 규칙 및 요금 체계를 공유합니다. 사용량에 맞는 요금제를 선택하세요. 프록시 트래픽은 별도로 과금됩니다.
V1과 V2(s)는 요청이 성공할 때마다 API 크레딧 1개를 차감합니다.
V2(s)가 인증 처리에 성공하면 크레딧 2개를 추가로 차감합니다. 지원되는 Cloudflare JS Challenge, Cloudflare Turnstile, DataDome 및 Incapsula 인증에 적용됩니다.
요청이 실패하면 기본 요청 크레딧은 차감하지 않습니다. 단, 인증 성공 시 차감된 크레딧 2개는 이후 응답이 실패해도 환불되지 않습니다.
유효한 세션을 재사용하면 인증 반복을 줄일 수 있지만, 성공한 요청마다 크레딧 1개는 계속 차감됩니다. 같은 세션의 후속 요청이 무료인 것은 아닙니다.
크레딧은 요금제 유효 기간 안에 사용하세요. 각 패키지의 만료일은 별도로 관리되며, 먼저 만료되는 크레딧부터 차감합니다.
Cloudbypass API의 동작 방식은 무엇인가요?
표준 HTTP 요청과 공통 연동 로직 및 요청 코드로 Cloudflare와 DataDome을 처리하며 기존 수집 프레임워크를 유지할 수 있습니다. 프록시 IP, 쿠키, 세션을 일관되게 유지하고 응답 상태와 내용을 확인하세요. 지원 여부는 대상 사이트와 인증 종류에 따라 다릅니다. 먼저 호환성을 테스트하세요. 공통 요금제가 모든 대상에 대한 접근을 보장하지는 않습니다.
Cloudbypass API는 어떻게 사용하나요? 코드 예제가 있나요?
V1과 V2(s) 버전의 차이점은 무엇인가요?
V2(s)는 JavaScript 렌더링(JS polling)을 지원합니다.
V2(s)에는 기본 프록시가 포함되지 않으며 Cloudbypass Proxy를 별도로 사용해야 합니다. V1은 기본 동적 프록시가 포함되어 있습니다.
V2(s)의 세션 파티션(part)은 무엇인가요?
세션 파티션은 Cloudflare 쿠키 관리를 위한 단위입니다. 검증이 완료되면 세션이 활성화되며, 해당 세션 동안 프록시 IP와 브라우저 지문은 10분간 고정됩니다.
part 값은 0~999 범위로 최대 1000개까지 사용 가능하며, part를 변경해 다른 프록시로 요청할 수 있습니다. 성공적인 요청이 발생하면 세션 유지 시간이 갱신됩니다.
V1과 V2(s) 중 어떤 버전을 사용해야 하나요?
최대 요청 동시 수는 얼마인가요?
모든 요금제의 최대 요청 동시 수는 초당 30건입니다.
오류 코드: "INSUFFICIENT_BALANCE"
오류 코드: "CHALLENGE_LOCK_OCCUPIED"
오류 메시지
"The current part is being challenged, please wait for the lock to be released."
원인
동일한 part를 여러 스레드 또는 사용자 계정에서 동시에 사용한 경우
이전 요청이 타임아웃 또는 중단으로 인해 아직 완료되지 않은 경우
해결 방법
잠금 해제 후 재시도
part 값을 0~999 범위 내에서 변경
오류 코드: "FORBIDDEN" / "V3 Challenge Failed"
해결 방법:
1. 프록시 IP 추출 시 유효 시간을 10분 이상으로 설정
2. 다른 국가/지역 IP로 교체하여 순환 사용
403, 503 또는 Access Denied 오류가 발생합니다
프록시 설정이 필요할 가능성이 높습니다. API 모드 또는 프록시 모드 중 하나를 선택해 사용하세요. 현재 프록시는 HTTP 프로토콜만 지원합니다.
Selenium 또는 Puppeteer를 지원하나요?
현재 Selenium 및 Puppeteer는 지원하지 않습니다. 브라우저를 실행하지 않는 요청 기반 방식이며, 필요 시 지문 브라우저와 함께 사용할 수 있습니다.
