Cloudbypass API FAQ

사용 중 발생하는 주요 이슈와 답변을 확인하거나 고객 지원에 문의할 수 있습니다

요금제 포인트는 어떻게 차감되나요?

API 요청이 성공한 경우에만 포인트가 차감됩니다. 실패한 요청은 차감되지 않습니다.
V1: 성공 요청 1회당 1포인트 차감
V2: 성공 요청 1회당 3포인트 차감 (기본 요청 1포인트 + JS 폴링 처리 2포인트)
V2 세션 유지 시간은 10분이며, 프록시와 part 값을 변경하지 않으면 세션이 유지되어 추가 검증 없이 재요청이 가능합니다.

포인트는 유효 기간 내 미사용 시 소멸됩니다.
재충전한 포인트는 기존 포인트와 별도로 계산되며, 먼저 구매한 포인트부터 우선 차감됩니다.

Cloudbypass API의 동작 방식은 무엇인가요?

HTTP 요청을 Cloudbypass API로 전달하면 API가 대신 요청을 전송하는 구조입니다. 이 과정에서 요청의 자동화 패턴을 완화하고 Cloudflare challenge 발생 가능성을 낮춥니다. Cloudflare 인증을 직접 클릭하거나 조작하지 않으며, 검증 흐름에 대응해 정상적인 페이지 접근을 지원합니다.

Cloudbypass API는 어떻게 사용하나요? 코드 예제가 있나요?

대상 웹사이트로 전송할 HTTP 요청을 그대로 Cloudbypass API에 전달하면 됩니다. 요청은 x-cb-host로 1:1 전달됩니다.
코드 생성기를 통해 cURL, JavaScript, TypeScript, Java, Python 등 다양한 언어의 요청 예제를 바로 생성할 수 있습니다.
API 및 프록시 예제 코드는 여기에서 확인할 수 있습니다.

V1과 V2 버전의 차이점은 무엇인가요?

V2는 JavaScript 렌더링(JS polling)을 지원합니다.
V2에는 기본 프록시가 포함되지 않으며 Cloudbypass Proxy를 별도로 사용해야 합니다. V1은 기본 동적 프록시가 포함되어 있습니다.

V2의 세션 파티션(part)은 무엇인가요?

세션 파티션은 Cloudflare 쿠키 관리를 위한 단위입니다. 검증이 완료되면 세션이 활성화되며, 해당 세션 동안 프록시 IP와 브라우저 지문은 10분간 고정됩니다.
part 값은 0~999 범위로 최대 1000개까지 사용 가능하며, part를 변경해 다른 프록시로 요청할 수 있습니다. 성공적인 요청이 발생하면 세션 유지 시간이 갱신됩니다.

V1과 V2 중 어떤 버전을 사용해야 하나요?

코드 생성기에서 먼저 V1으로 테스트하세요.
접근이 어려운 경우 V2를 사용하면 됩니다. V2 사용 시 프록시가 필요하며, 테스트용 프록시는 프록시 콘솔에서 추출할 수 있습니다. IP 유효 시간은 10분 이상 권장합니다.

최대 요청 동시 수는 얼마인가요?

모든 요금제의 최대 요청 동시 수는 초당 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는 지원하지 않습니다. 브라우저를 실행하지 않는 요청 기반 방식이며, 필요 시 지문 브라우저와 함께 사용할 수 있습니다.

체험 이벤트
+ API 크레딧 200
+ 동적 IP 프록시 트래픽
지금 받기 ›