リクエスト失敗の原因を調べる
HTTP ステータス、エラーコード、応答内容を確認し、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回答文書 | ドキュメントには、V1 が 5 秒間のシールドに遭遇する場合のヒントがリストされています。ターゲットを検証した後に 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すべてのバージョン回答文書 | まず同時実行性を減らし、効果的な再試行後を遵守し、サイトとアカウントのクォータを確認し、デフォルトで電流制限を処理するために IP の変更に依存しないようにします。 | 下がって待ちます |
BAD_GATEWAYすべてのバージョン回答文書 | プロキシ、ゲートウェイ、ターゲットオリジンを区別し、失敗時間とリクエスト ID を記録します。一時的な失敗は安全に取り消して再試行できます。 | 制限された再試行 |
SERVICE_UNAVAILABLEすべてのバージョン回答文書 | ターゲットまたはゲートウェイが一時的に利用できなくなっていないかどうかを確認します。期限に応じてリトライを制御し、連続失敗後のフィードバックを実現します。 | 制限された再試行 |
SOURCE_SERVER_ERRORすべてのバージョン回答文書 | 発信元サイトのエラー応答を確認し、無関係なパラメータを繰り返し変更しないでください。ステータス、時刻、リクエストIDを保持します。 | 制限された再試行 |
INTERNAL_ERRORすべてのバージョン回答文書 | Scrapingbypass API によって返されたリクエスト ID、時間、および感度解除応答を保持します。引き続き発生する場合は、テクニカル サポートに引き渡してください。 | フィードバックサポート |
GATEWAY_TIMEOUT実際に返却して確認AIガイドサプリメント | ローカル ゲートウェイ、プロキシ、またはアップストリームのいずれであるかを特定し、タイムアウトを待ってから、安全で再現可能な一時的なエラーが発生するまで再試行します。 | 制限された再試行 |
出典:応答データ、AIアクセス障害診断。不明なエラーは元の値を保持しており、一律に「IP の変更」として分類されません。
まず証拠を保管してくださいもう一度試すかどうかを決定する
01. HTTP 応答はありますか?
応答がない場合は、まず動作環境、DNS、ネットワーク、証明書、クライアントのタイムアウトを確認してください。サーバーエラーコードをでっち上げないでください。
02. 2 つのレベルの結果を読み取る
x-cb-status: ok は、API リクエストが正常に処理されたことを意味します。ターゲットのステータス、Content-Type、およびビジネス コンテンツを引き続き確認する必要があります。
03. エラーフィールドを保持する
API エラー JSON は ID、コード、メッセージを使用します。 SDK は例外をスローする可能性があるため、実際の応答を読み取る必要があります。
04. 安全に再実行できるリクエストのみを再試行してください
設定エラー、残高不足、明示的な権限がない場合に停止します。一時的な障害に対する限定的なバックオフ。副作用のある操作では、冪等性または最後の実行結果が最初に確認されます。
エラー応答構造体
{
"id": "<request-id>",
"code": "PARAMS_ERROR",
"message": "<error-message>"
}フィールド値は参照用です。トラブルシューティングの際は実際の応答を保持し、元のエラーをカバーするために例を使用しないでください。
| 観察された状況 | 判断を優先する |
|---|---|
| 200/HTML | それはターゲット コンテンツである可能性もあれば、ログイン ページまたは確認ページである可能性もあります。まずは事業分野を確認してください。 |
| 403 | 応答ヘッダーと本文を組み合わせて、チャレンジ、アカウント権限、地域制限を区別します。 |
| 429 | 同時実行性を減らすために、最初に電流制限と再試行後を確認してください。 |
| 5xx | ローカル ゲートウェイ、プロキシ、ターゲット オリジン、および API によって返されるエラーを区別します。 |

バージョン、プロキシ、セッション一緒に確認する必要があります
01. クッキーとパーツは混ざらない
Cookie モードはクライアントによって保存され、暗号化された検証 Cookie を送信します。パート モードはサーバーによってホストされます。部品検証セッションは 10 分間保持され、その間に成功したリクエストを更新できますが、プロキシの有効期間は延長されません。
02. エクスポート変更後のセッションの再構築
チャレンジ中は IP、フィンガープリント、プロキシの一貫性を保ちます。出口を変更した後は新しいパートまたは Cookie セッションを使用し、同じパーティション内でプロキシを同時に切り替えないでください。
03. セッションロックは最初にキューに入れられます
最初の課題は、セッションごとに同時実行性を制御します。ロックが占有されている場合は、独立したタスクを待機するか分離します。デフォルトでは、セッション制約をバイパスするためにignore-lockとforceは使用されません。
インターフェイスのバージョン、プロキシ、タイムアウトのチェック
| バージョン | リクエストとセッション | x-cb-timeout |
|---|---|---|
| V1 | デフォルトで動的プロキシが付属しています。各リクエストはステートレスです。 x-cb-proxy は必要に応じて設定できます。 | デフォルトは 30 秒です。 Go V1 の場合は 5 ~ 3600 秒。不正な値は無視される場合があります。 |
| V2 | x-cb-version: 2;固定または時間制限のあるプロキシを提供する必要があります。Cookie または Part モードを選択してください。 | デフォルトは 15 秒です。現在の Python V2 は 5 ~ 360 秒で、不正な値は PARAMS_ERROR を返します。 |
| V2s | x-cb-version: 2秒; V2 プロキシとセッションの要件に従い、ストリーミング HTTP 応答をサポートします。 | デフォルトは 30 秒です。範囲は 5 ~ 3600 秒です。クライアントは引き続き独自の待機バジェットを設定する必要があります。 |
紛らわしいリクエスト構成
| 構成 | 確認事項 |
|---|---|
| URL と x-cb-host | API URL はターゲット パスとクエリ パラメータを保持します。 x-cb-host は、ターゲット ホスト名と必要なポートを入力しますが、プロトコルやパスは入力しません。 |
| x-cb-protocol | ターゲットが HTTP の場合は、明示的に http に設定されます。設定されていない場合、デフォルトは https です。 |
| x-cb-proxy | これは、API サービスがターゲットにアクセスするときの終了であり、ローカル HTTP クライアントのプロキシを構成することと同等ではありません。認証、協定、入手可能性、輸出の安定性を確認します。 |
| x-cb-part | V2/V2s のみ。ドキュメントのデフォルト範囲は 0 ~ 998 の整数ですが、実際の範囲はサービスの制限に従います。さまざまなタスク用にパーティションを分離します。 |
| x-cb-sitekey | Turnstile には [cf_token] または %5Bcf_token%5D プレースホルダーを指定する必要があります。 JS クエリでは、サイトキーを入力する必要はありません。 |
| x-cb-fp / x-cb-ua | UA の動作に対して実際のバージョンのフィンガープリントを確認します。現在、Python V2 は x-cb-ua を無視し、ブラウザーのバージョン番号をランダムに結合しません。 |
| リダイレクトと構成オプション | リダイレクトはデフォルトで処理されます。 3xx と Set-Cookie を確認する必要がある場合は、disable-redirect を参照してください。 wait-lock は非推奨となり、ignore-lock と Force はデフォルトのパッチとして使用されません。 |
| タイムアウトと再試行 | 有効な x-cb-timeout は、長いタイムアウトよりも優先されます。クライアント、SDK、プロキシ、およびタスクの期限は、複数の層の自動再試行が重なることを避けるために個別にチェックされます。 |
パラメータ ページと応答ページのプロキシ プロトコルの説明には違いがあるため、使用されているバージョンと実際のメッセージに基づいて確認する必要があります。完全なフィールド、利用可能な範囲、実装の違いは次のとおりです。最新のリクエストパラメータドキュメントが勝つだろう。
V2s はストリーミング応答であり、公式のバックグラウンド タスク、ポーリング、またはコールバック インターフェイスではありません。ダウンロードでは、宛先のステータス、コンテンツ タイプ、整合性をチェックする必要があります。 200 もファイルの存在も、成功を証明するには十分ではありません。
書類とツール、質問で入り口を見つける
開始と応答性
- クイックスタート
V1/V2/V2、チャレンジ タイプと 2 つのセッション モード。
- リクエストパラメータ
宛先パス、リクエストヘッダー、フィンガープリント、タイムアウト、構成オプション。
- 応答データ
x-cb-status、エラー JSON および公式エラー コード テーブル。
- 口座残高を確認する
POST + JSON クエリ ポイントまたはプロキシ トラフィック。
SDK と AI アクセス
- Python SDK
セッション/SessionV2、非同期呼び出しおよびバランス クエリ。
- Node.js SDK
cb_version、エラー識別および環境変数の優先順位。
- SDK に行く
クライアント、パーツ/Cookie、およびプロキシ機能。
- Vibe Coding ガイド
ランタイム環境、エラーの階層化、制限された再試行、および AI タスクの境界。
ツールとコレクター
- API からローカル プロキシ ツールへ
リスニング アドレス、デフォルト キー、および x-cb-proxy を確認します。
- Nginx 転送構成
サーバーはキーを保持し、ホスト、SNI、およびアクセス スコープをチェックします。
- コレクターの構成
ローカル プロキシ ツールを再利用します。スクリーンショットの x-cb-host をコピーしないでください。
請求、トライアル、および機能の境界
- ポイント消費
成功したリクエストと成功したチャレンジは別々に請求されます。
- トライアル版を入手する
登録後、書類に従ってカスタマーサービスまでご連絡ください。
- 指紋認証ブラウザと自動境界線
この文書は明らかに、指紋ブラウザ Selenium および Puppeteer での直接使用をサポートしていません。
- WebSocket 境界
現在のドキュメントは、ws/wss を明示的にサポートしていません。
ポイント、残高、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 ステータス、Content-Type、およびビジネス フィールドを確認します。 x-cb-status: ok は、Scrapingbypass API リクエストが正常に処理されたことを意味しますが、ログイン、注文、ファイル保存などのサービスを完了する必要があることを意味するわけではありません。
応答がない場合、どのエラーコードを確認すればよいですか?
HTTP 応答がない場合、Scrapingbypass API サーバー エラー コードは作成できません。まず、ローカルの依存関係、動作環境、DNS、ネットワーク、証明書、クライアントのタイムアウトを確認します。応答を受信したら、実際の ID、コード、メッセージを読み取ります。
すべての 403 を V2 に切り替える必要がありますか?
No. 403 は、アカウントの権限なし、地域制限、または対象となるビジネス ルールに起因する場合もあります。 V1 が明確に CLOUDFLARE_PREMIUM を要求するか、V2 を要求する情報を返した場合は、V2 と安定したプロキシを構成します。通常の権限エラーは、バージョンをアップグレードしても自動的には消えません。
DataDome 特別なリクエスト ヘッダーを追加する必要がありますか?
クイック スタートのドキュメントには、追加の DataDome 専用ヘッダーを必要とせずに、DataDome チャレンジが V2 によって自動的に認識されると記載されています。固定またはスティッキー x-cb-proxy を引き続き構成し、一致する Cookie または部分セッションを使用する必要があります。ターゲットの互換性については実際の検証が必要です。
サイトキーを入力しても Turnstile が完了しないのはなぜですか?
x-cb-sitekey は、[cf_token] または URL、リクエスト ヘッダー、またはリクエスト本文内の URL エンコードされたプレースホルダーとも一致する必要があります。 Scrapingbypass API は、一般的な戻り値としてネイキッド トークンをクライアントに直接渡すのではなく、プレースホルダーを置き換えてターゲット リクエストを転送します。
失敗したリクエストでもポイントが消費されるのはなぜですか?
ドキュメントではリクエスト ポイントとチャレンジ ポイントが区別されています。リクエストが成功すると 1 ポイントが消費され、V2 では検証チャレンジが成功するごとに追加の 2 ポイントが消費されます。チャレンジが成功した後、その後の応答が正しくなかった場合、差し引かれたチャレンジ ポイントは返されませんが、失敗した応答に対するリクエスト ポイントは差し引かれません。多段階検証は段階ごとに計算されます。
V2s はバックグラウンド非同期タスク インターフェイスと同等ですか?
いいえ、V2 は HTTP 応答をストリーミングしており、公式のバックグラウンド タスク、ポーリング、またはコールバック サービスを自動的に提供しません。クライアントからの非同期呼び出しは、サーバー上でタスクを作成することを意味するものではなく、ダウンロードでも実際のコンテンツと整合性を検証する必要があります。
問題を報告する場合、API キーを送信する必要がありますか?
必要ありません。時刻とタイムゾーン、リクエストID、感度解除ターゲット、バージョン、コード/メッセージ、プロキシのリージョンとタイプ、試行記録を指定するだけです。 API キー、プロキシ パスワード、ログイン Cookie、完全なリクエスト本文、またはトークンを含むクエリ パラメータを送信しないでください。

サポートに連絡するときは、この情報を保管してください
- 発生時刻とタイムゾーン、リクエストID
- 感度解除ターゲット、API バージョン、HTTP ステータス
- x-cb-status、元のコードと感度を解除されたメッセージ
- プロキシの種類、地域、有効期間、セッション モード
- 試した手順と最終結果
キー、プロキシ パスワード、ログイン Cookie、または機密のクエリ パラメータは付属しません。リクエストIDがない場合は、リクエストIDをそのまま指定し、代替値を生成しません。
