요청 실패의 원인을 확인하세요

HTTP 상태, 오류 코드와 응답 내용을 확인한 뒤 API 버전, 프록시 및 세션 설정을 점검하세요.

API 응답의 예외 필드 및 요청 로그를 검사하기 위한 돋보기

오류 코드 검색

31개의 공식 오류 코드와 9개의 지침 보충 예시를 오류 유형별로 정리했습니다. 처리 제안은 실제 버전 및 메시지와 결합되어야 합니다.

매개변수 및 계정

매개변수 및 계정: 코드, 적용 가능한 버전 및 문제 해결 제안
오류 코드/문서 소스문제 해결 제안다음 단계
PARAMS_ERROR모든 버전응답 문서 누락된 필드, 유형 및 범위를 확인하고 메시지로 수정하세요. V2의 잘못된 시간 초과 값도 이 오류를 유발할 수 있습니다.구성 수정
USER_AGENT_INVALIDv1/v2/v2s응답 문서 먼저 해결되지 않은 x-cb-ua를 제거하거나 기본 지문으로 돌아가서 현재 버전의 UA 지원 범위를 확인하세요.구성 수정
APIKEY_INVALID모든 버전응답 문서 실제 동작 환경이 유효한 키를 읽었는지 확인하고, 비활성화 또는 리셋 상태를 확인하고, IP 변경으로 해결하지 마십시오.재시도 중지
INSUFFICIENT_BALANCE모든 버전응답 문서 API 포인트 잔액 및 만료 시간을 쿼리합니다. 프록시 트래픽은 또 다른 용도이므로 서로 대체할 수 없습니다.재시도 중지
HOSTNAME_IS_FORBIDDEN모든 버전응답 문서 대상 도메인 이름과 접근 권한을 확인하고 메시지를 보관하세요. 명시적인 액세스 제한을 회피하려고 시도하지 마십시오.수동 확인
HOSTNAME_IS_NULL모든 버전응답 문서 x-cb-host를 완료하세요. 프로토콜, 경로 또는 쿼리 매개변수 없이 대상 호스트 이름과 필요한 포트만 입력하세요.구성 수정
HOSTNAME_IS_INVALID실제 반품으로 확인AI 가이드 보충 API 요청 URL에 경로와 쿼리 매개변수를 유지하면서 대상 호스트와 포트를 확인하세요.구성 수정
PART_ERROR실제 반품으로 확인AI 가이드 보충 x-cb-part의 정수 형식과 계정의 실제 사용 가능한 범위를 확인하고, 다른 작업에 파티션을 무작위로 재사용하지 마십시오.구성 수정
INVALID_SITEKEY실제 반품으로 확인AI 가이드 보충 대상의 Turnstile 사이트 키를 확인하고 요청에 [cf_token] 자리 표시자도 포함되어 있는지 확인하세요.구성 수정

프록시·네트워크·인증서

프록시, 네트워크 및 인증서: 코드, 적용 가능한 버전 및 문제 해결 제안
오류 코드/문서 소스문제 해결 제안다음 단계
PROXY_ERROR모든 버전응답 문서 프록시 계정, 프로토콜, 포트, 가용성 기간 및 트래픽을 확인하고 프록시에서 반환된 오류와 대상 사이트에서 반환된 오류를 구별합니다.링크 확인
PROXY_FORMAT_ERROR모든 버전응답 문서 요청 매개변수 문서에 따라 프록시 형식을 확인하고 사용된 버전이 프로토콜을 허용하는지 확인하세요. 접두사를 다시 쓴다고 해서 프로토콜을 변환하는 것은 아닙니다.구성 수정
PROXY_IS_FORBIDDEN모든 버전응답 문서 서비스에서 프록시 주소를 사용할 수 있는지 확인하고 대신 유효하고 허용된 프록시를 사용하세요. 동일한 금지 주소를 반복적으로 제출하지 마십시오.재시도 중지
CONNECTION_ERROR모든 버전응답 문서 로컬 머신에서 API, API에서 프록시와 타겟으로의 연결을 구별하고 메시지를 기준으로 주소와 회선을 확인합니다.링크 확인
DNS_ERROR모든 버전응답 문서 먼저 실패한 도메인 이름이 로컬 API 도메인 이름, 프록시 도메인 이름 또는 대상 도메인 이름인지 확인하고 각각 해결 및 시간 초과를 확인하십시오.링크 확인
TLS_ERROR모든 버전응답 문서 대상 및 프록시 프로토콜, 시스템 시간 및 인증서 체인을 확인하십시오. TLS 확인을 기본값으로 끄지 않는 문제를 해결하세요.링크 확인
CERT_ERROR모든 버전응답 문서 인증서 체인, 프록시 중간 인증서 및 대상 주소를 확인하십시오. 단순히 인증서 실패를 IP 문제로 돌리지 마십시오.링크 확인
REQUEST_ERROR모든 버전응답 문서 시간 초과, 거부 및 연결 중단은 메시지로 구분되며 안전하게 재생 가능한 임시 실패에만 재시도가 제한됩니다.제한된 재시도
EOF_ERROR모든 버전응답 문서 연결이 조기에 종료되었는지, 프록시가 만료되었는지, 파일이 완전한지 여부를 확인하고, 잘린 응답을 성공으로 처리하지 마십시오.링크 확인
RESOLVE_PROXY실제 반품으로 확인AI 가이드 보충 실제 운영 환경에서 프록시 호스트의 DNS를 확인하고, 확인 실패 메시지를 기록합니다.링크 확인
PROXY_CONNECT_ABORTED실제 반품으로 확인AI 가이드 보충 프록시 인증, 유효기간, 접속 중단 사유 등을 확인하고, 일시적인 장애 발생 시 예산 내에서만 다시 시도하세요.링크 확인
TIMEOUT_ERROR실제 반품으로 확인AI 가이드 보충 클라이언트 대기, API 타임아웃, 목표 응답을 구분하고, 타임아웃을 늘리기 전에 총 작업 예산을 확인하세요.시간 초과 확인
SSL_ERROR실제 반품으로 확인AI 가이드 보충 대상, 프록시 및 클라이언트 인증서 체인과 프로토콜을 확인하고 기본적으로 인증서 확인을 비활성화하지 마십시오.링크 확인

인증 챌린지 및 세션

검증 과제 및 세션: 코드, 적용 가능한 버전 및 문제 해결 제안
오류 코드/문서 소스문제 해결 제안다음 단계
UNSUPPORTED_CAPTCHA모든 버전응답 문서 검증 유형과 둔감화 응답을 유지하고 지원 경계를 확인한 후 기술 지원에 문의하고 무한 재시도를 하지 마십시오.재시도 중지
CLOUDFLARE_PREMIUMv1응답 문서 문서에는 5초 보호막이 발생하는 V1에 대한 팁이 나열되어 있습니다. 대상 확인 후 V2로 전환하고 고정 또는 고정 프록시를 준비합니다.버전 조정
CLOUDFLARE_CHALLENGE_TIMEOUTv2응답 문서 송신 안정성, 프록시 유효성, 2계층 시간 제한을 확인하세요. 예산으로 다시 시도하고 필요한 경우 새 세션으로 확인하세요.제한된 재시도
DATADOME_CHALLENGE_TIMEOUTv2응답 문서 고정/고정 프록시 및 도전 시간 예산을 확인하세요. 지속적인 실패는 요청 ID를 유지하고 지연 없이 성공합니다.제한된 재시도
DATADOME_ACCESS_DENIEDv2응답 문서 대상 권한, 지역 및 수출 평판을 확인하십시오. 기준에 따라 허용된 내보내기를 변경하고 동시에 세션을 다시 설정합니다.수동 확인
CHALLENGE_LOCK_TIMEOUTv2응답 문서 동일한 세션을 기다리는 챌린지가 여전히 있는지 확인하세요. wait-lock은 현재 매개변수 문서에서 더 이상 사용되지 않습니다.대기열 우선
CHALLENGE_LOCK_OCCUPIEDv2응답 문서 동시성을 줄이기 위해 동일한 세션의 첫 번째 챌린지가 끝날 때까지 기다립니다. 독립 작업은 독립적으로 사용 가능한 파티션을 사용합니다.대기열 우선
BYPASS_ERRORv2응답 문서 메시지를 먼저 읽고 세션 중에 프록시가 변경되었는지 확인하는 데 집중하세요. 먼저 새 세션을 생성하면 강제가 기본 구성으로 사용되지 않습니다.세션 확인
PROXY_NON_STICKYv2응답 문서 이 확인은 Scrapingbypass API 프록시에만 적용됩니다. 대신 유효한 고정/고정 종료를 사용하고 새 인증 세션을 생성하세요.수정 프록시
INCAPSULA_ACCESS_DENIED실제 반품으로 확인AI 가이드 보충 실제 거부 이유와 비교하여 대상 라이선스, 지역 및 수출을 확인합니다. 표적 호환성을 확인하기 위한 증거를 보관하십시오.수동 확인

대상 제한 및 서비스 오류

대상 제한 및 서비스 예외: 코드, 적용 가능한 버전 및 문제 해결 제안
오류 코드/문서 소스문제 해결 제안다음 단계
FORBIDDEN모든 버전응답 문서 대상 권한, 로그인 상태, 응답 본문을 먼저 확인하세요. 명확한 인증 확인 프롬프트가 있는 경우에만 V2를 고려하고 모든 403을 검증으로 처리하지 마십시오.수동 확인
ACCESS_DENIED모든 버전응답 문서 대상의 허용 지역, 계정 권한, 내보내기 평판을 확인하고 액세스 거부에 대한 구체적인 증거를 보관하십시오.수동 확인
TOO_MANY_REQUESTS모든 버전응답 문서 먼저 동시성을 줄이고 효과적인 Retry-After를 준수하고, 사이트 및 계정 할당량을 확인하고, 기본적으로 현재 제한을 처리하기 위해 IP 변경에 의존하지 마십시오.물러서서 기다려라
BAD_GATEWAY모든 버전응답 문서 프록시, 게이트웨이, 대상 원본을 구별하고 실패 시간과 요청 ID를 기록합니다. 일시적인 오류는 안전하게 백업하고 다시 시도할 수 있습니다.제한된 재시도
SERVICE_UNAVAILABLE모든 버전응답 문서 대상 또는 게이트웨이를 일시적으로 사용할 수 없는지 확인하십시오. 기한에 따른 재시도를 제어하고 지속적인 실패 후 피드백을 제공합니다.제한된 재시도
SOURCE_SERVER_ERROR모든 버전응답 문서 원본 사이트 오류 응답을 확인하고 관련 없는 매개변수를 반복적으로 수정하지 마십시오. 상태, 시간 및 요청 ID를 유지합니다.제한된 재시도
INTERNAL_ERROR모든 버전응답 문서 Scrapingbypass API에서 반환된 요청 ID, 시간 및 둔감화 응답을 유지합니다. 계속해서 발생하면 기술 지원에 문의하십시오.피드백 지원
GATEWAY_TIMEOUT실제 반품으로 확인AI 가이드 보충 로컬 게이트웨이인지, 프록시인지, 업스트림인지 확인하고 시간 초과를 기다린 후 안전하고 재생 가능한 임시 오류가 발생하는지 다시 시도하세요.제한된 재시도

출처:응답 데이터、AI 접속 장애 진단. 알 수 없는 오류는 원래 값을 유지하며 "IP 변경"으로 일률적으로 분류되지 않습니다.

증거를 먼저 확보하세요다시 시도할지 결정

01. HTTP 응답이 있습니까?

응답이 없으면 먼저 운영 환경, DNS, 네트워크, 인증서 및 클라이언트 시간 초과를 확인하십시오. 서버 오류 코드를 구성하지 마십시오.

02. 두 가지 수준의 결과 읽기

x-cb-status: ok는 API 요청이 성공적으로 처리되었음을 의미합니다. 대상 상태, 콘텐츠 유형 및 비즈니스 콘텐츠를 계속 확인해야 합니다.

03. 오류 필드 유지

API 오류 JSON는 ID, 코드, 메시지를 사용합니다. SDK에서 예외가 발생할 수 있으므로 실제 응답을 읽어야 합니다.

04. 재생해도 안전한 요청만 재시도하세요

구성 오류, 잔액 부족, 명시적인 권한 없음으로 인해 중지됩니다. 일시적인 장애에 대한 제한된 백오프 부작용이 있는 작업은 먼저 멱등성 또는 마지막 실행 결과를 확인합니다.

오류 응답 구조

{
  "id": "<request-id>",
  "code": "PARAMS_ERROR",
  "message": "<error-message>"
}

필드 값은 참조용입니다. 문제 해결 시 실제 응답을 유지하고 원래 오류를 다루기 위해 예제를 사용하지 마십시오.

HTTP 현상이 Scrapingbypass API 서비스 오류 코드와 동일하지 않습니다.
관찰된 상황판단을 최우선으로 한다
200/HTML대상 콘텐츠일 수도 있고, 로그인 페이지나 확인 페이지일 수도 있습니다. 사업 분야를 먼저 확인해보세요.
403응답 헤더와 본문을 결합하여 챌린지, 계정 권한 및 지역 제한 사항을 구분합니다.
429동시성을 줄이려면 먼저 전류 제한과 Retry-After를 확인하세요.
5xx로컬 게이트웨이, 프록시, 대상 원본 및 API에서 반환된 오류를 구별합니다.

전체 응답 규칙 보기

API 요청 매개변수, 프록시 종료 및 안정 세션 간의 구성 관계

버전, 프록시 및 세션함께 확인해야 함

01. 쿠키와 부품은 섞이지 않습니다

쿠키 모드는 클라이언트에 의해 저장되며 암호화된 확인 쿠키를 보냅니다. 부품 모드는 서버에서 호스팅됩니다. 부품 검증 세션은 10분 동안 유지되며, 이 동안 성공적인 요청은 갱신될 수 있지만 프록시 유효 기간은 연장되지 않습니다.

02. 내보내기 변경 후 세션 재구축

챌린지 중에 IP, 지문, 프록시를 일관되게 유지하세요. 종료를 변경한 후 새 파트 또는 쿠키 세션을 사용하고 동일한 파티션에서 동시에 프록시를 전환하지 마십시오.

03. 세션 잠금이 먼저 대기열에 추가됩니다.

첫 번째 과제는 세션별로 동시성을 제어합니다. 잠금이 사용 중일 때 독립적인 작업을 기다리거나 격리하며, 세션 제약 조건을 우회하기 위해 기본적으로 잠금 무시 및 강제 실행이 사용되지 않습니다.

인터페이스 버전, 프록시 및 시간 초과 확인
버전요청 및 세션x-cb-timeout
V1기본적으로 동적 프록시가 함께 제공됩니다. 각 요청은 상태 비저장입니다. 필요에 따라 x-cb-proxy를 구성할 수 있습니다.기본값은 30초입니다. Go V1의 경우 5~3600초. 잘못된 값은 무시될 수 있습니다.
V2x-cb-version: 2; 고정 또는 시간에 민감한 프록시를 제공해야 합니다. 쿠키 또는 부분 모드를 선택하세요.기본값은 15초입니다. 현재 Python V2는 5~360초이고 잘못된 값은 PARAMS_ERROR를 반환합니다.
V2sx-cb-version: 2초; V2 프록시 및 세션 요구 사항을 따르고 스트리밍 HTTP 응답을 지원합니다.기본값은 30초입니다. 범위는 5~3600초입니다. 고객은 여전히 ​​자신의 대기 예산을 구성해야 합니다.
혼란스러운 요청 구성
구성확인해야 할 사항
URL 및 x-cb-hostAPI URL은 대상 경로와 쿼리 매개변수를 유지합니다. x-cb-host는 대상 호스트 이름과 필요한 포트를 채우지만 프로토콜이나 경로는 채우지 않습니다.
x-cb-protocol대상이 HTTP인 경우 명시적으로 http로 설정됩니다. 설정되지 않은 경우 기본값은 https입니다.
x-cb-proxy이는 API 서비스가 대상에 액세스할 때의 종료이며 로컬 HTTP 클라이언트에 대한 프록시를 구성하는 것과 동일하지 않습니다. 인증, 계약, 가용성 및 수출 안정성을 확인하세요.
x-cb-partV2/V2에만 해당; 문서 기본 범위는 정수 0~998이며 실제 범위에는 서비스 제한이 적용됩니다. 다양한 작업을 위해 파티션을 격리합니다.
x-cb-sitekeyTurnstile는 [cf_token] 또는 %5Bcf_token%5D 자리 표시자와 함께 제공되어야 합니다. JS 쿼리에는 사이트 키를 입력할 필요가 없습니다.
x-cb-fp / x-cb-uaUA 동작과 비교하여 실제 버전의 지문을 확인합니다. 현재 Python V2는 x-cb-ua를 무시하고 브라우저 버전 번호를 무작위로 연결하지 않습니다.
리디렉션 및 구성 옵션리디렉션은 기본적으로 처리됩니다. 3xx 및 Set-Cookie를 확인해야 하는 경우 비활성화-리디렉션을 참조하세요. wait-lock은 더 이상 사용되지 않으며,ignore-lock 및 force는 기본 패치로 사용되지 않습니다.
시간 초과 및 재시도유효한 x-cb-timeout가 긴 시간 초과보다 우선합니다. 클라이언트, SDK, 프록시 및 작업 기한은 여러 계층의 자동 재시도 중첩을 피하기 위해 별도로 확인됩니다.

매개변수 페이지와 응답 페이지의 프록시 프로토콜 설명에 차이가 있으므로 사용된 버전과 실제 메시지를 기반으로 확인해야 합니다. 전체 필드, 사용 가능한 범위 및 구현 차이점은 다음과 같습니다.최신 요청 매개변수 문서승리할 것이다.

V2s는 공식적인 백그라운드 작업, 폴링 또는 콜백 인터페이스가 아닌 스트리밍 응답입니다. 다운로드는 대상 상태, 콘텐츠 유형 및 무결성을 확인해야 합니다. 200이나 파일의 존재만으로는 성공을 증명하기에 충분하지 않습니다.

문서와 도구, 질문으로 입구를 찾아보세요

시작 및 대응

SDK 및 AI 액세스

도구 및 수집가

청구, 평가판 및 기능 경계

포인트, 잔액 및 SDK 구성 차이점

먼저 API 포인트와 프록시 트래픽을 구별합니다.

공식 문서 설명: 요청이 성공하면 1포인트가 소모되고, V2 인증 문제가 성공할 때마다 추가로 2포인트가 소모됩니다. 다단계 검증 비용은 별도로 청구됩니다. 챌린지 성공 후 후속 응답이 잘못된 경우, 이미 차감된 챌린지 포인트는 반환되지 않지만, 실패한 응답에 대해서는 요청 포인트가 차감되지 않습니다. SDK 자동으로 리디렉션 응답을 따르는 경우에도 포인트가 소모됩니다.

밸런스 인터페이스는 POST https://console.cloudbypass.com/api/v1/balance, JSON 필드 사용 apikey、email、type。points 포인트와 유효기간을 확인하세요.res / dat 주거용/컴퓨터실 트래픽을 쿼리합니다. 단위는 바이트입니다. 이전 GET 쿼리는 더 이상 사용되지 않으며 URL에 자격 증명을 입력하지 않습니다.

SDK에는 다양한 환경 변수 규칙이 있습니다. Python / Go 문서 사용법 CB_APIKEY、CB_PROXY;Node.js 우선순위 읽기 CLOUDBYPASS_APIKEY、CLOUDBYPASS_PROXY, 비어 있으면 다시 읽으세요 CB_*. AI 가이드의 변수는 모든 SDK 또는 원격 MCP 환경에서 자동으로 나타나지 않습니다.

로컬 프록시 도구와 Nginx는 모두 전달 액세스 방법입니다. 키는 신뢰할 수 있는 운영 환경에 저장되며 모니터링 범위와 액세스 권한을 제어해야 합니다. 문서에서는 지문 브라우저인 Selenium/Puppeteer에서 직접 사용을 명시적으로 지원하지 않으며 WebSocket에 대해 ws/wss를 지원하지 않으며 HTTP 스트리밍 응답을 이러한 기능과 혼동하지 않습니다.

자주 묻는 질문 및 피드백 증거

HTTP 200은 임무가 성공했다는 뜻인가요?

아니요. 먼저 x-cb-status를 확인한 다음 대상 HTTP 상태, 콘텐츠 유형 및 비즈니스 필드를 확인하세요. x-cb-status: ok는 Scrapingbypass API 요청이 성공적으로 처리되었음을 의미하지만 로그인, 주문 또는 파일 저장 및 기타 서비스가 완료되어야 한다는 의미는 아닙니다.

HTTP 응답이 없으면 Scrapingbypass API 서버 오류 코드를 조작할 수 없습니다. 먼저 로컬 종속성, 운영 환경, DNS, 네트워크, 인증서 및 클라이언트 시간 초과를 확인하십시오. 응답을 받은 후 실제 ID, 코드 및 메시지를 읽으십시오.

403번은 계정 권한 없음, 지역 제한 또는 대상 비즈니스 규칙에서 나올 수도 있습니다. V1이 CLOUDFLARE_PREMIUM를 명확하게 표시하거나 V2를 요청하는 정보를 반환하면 V2와 안정적인 프록시를 구성합니다. 업그레이드된 버전으로 인해 일반 권한 오류가 자동으로 사라지지 않습니다.

빠른 시작 문서에는 추가 DataDome 전용 헤더가 필요 없이 V2에서 DataDome 챌린지를 자동으로 인식한다고 명시되어 있습니다. 고정 또는 고정 x-cb-proxy는 계속 구성되어야 하며 일치하는 쿠키 또는 부분 세션을 사용해야 합니다. 대상 호환성에는 실제 검증이 필요합니다.

또한 x-cb-sitekey는 [cf_token] 또는 URL, 요청 헤더 또는 요청 본문의 URL 인코딩 자리 표시자와 일치해야 합니다. Scrapingbypass API는 기본 토큰을 일반 반환 값으로 클라이언트에 직접 제공하는 대신 자리 표시자를 대체하고 대상 요청을 전달합니다.

문서에서는 요청 포인트와 챌린지 포인트를 구분합니다. 성공적인 요청은 1포인트를 소비하고 V2는 각 성공적인 확인 챌린지에 대해 추가로 2포인트를 소비합니다. 챌린지 성공 후 후속 응답이 올바르지 않은 경우, 차감된 챌린지 포인트는 반환되지 않지만, 실패한 응답에 대한 요청 포인트는 차감되지 않습니다. 다단계 검증은 단계별로 계산됩니다.

아니요. V2는 HTTP 응답을 스트리밍하며 공식 백그라운드 작업, 폴링 또는 콜백 서비스를 자동으로 제공하지 않습니다. 클라이언트의 비동기 호출은 서버에서 작업을 생성하는 것을 의미하지 않으며 다운로드에서는 실제 콘텐츠와 무결성을 확인해야 합니다.

필요하지 않습니다. 시간 및 시간대, 요청 ID, 민감도 감소 대상, 버전, 코드/메시지, 프록시 지역 및 유형, 시도 기록만 제공하면 됩니다. API 키, 프록시 비밀번호, 로그인 쿠키, 전체 요청 본문 또는 쿼리 매개변수를 토큰과 함께 보내지 마세요.

발생시간, 오류대응, 진단기록을 정리하여 기술지원팀에 피드백

지원팀에 문의할 때 이 정보를 보관하세요

  • 발생 시간 및 시간대, 요청 ID
  • 둔감화 대상, API 버전, HTTP 상태
  • x-cb-status, 원본 코드 및 둔감화된 메시지
  • 프록시 유형, 지역, 유효 기간 및 세션 모드
  • 시도한 단계 및 최종 결과

키, 프록시 비밀번호, 로그인 쿠키 또는 민감한 쿼리 매개변수는 제공되지 않습니다. 요청 ID가 없으면 사실대로 지정하고 대체 값을 생성하지 마십시오.

AI 액세스 및 사용 시나리오

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