Cloudbypass API よくある質問
クレジットの消費方法はどのように計算されますか?
Cloudflare と DataDome は同じ API クレジット残高、消費ルール、料金体系を使用します。利用量に合わせてプランを選んでください。プロキシ通信量は別途課金されます。
V1 と V2(s) は、リクエストが成功するたびに API クレジットを 1 消費します。
V2(s) が検証に成功すると、追加で 2 クレジットを消費します。対象は対応する Cloudflare JS Challenge、Cloudflare Turnstile、DataDome、Incapsula の検証です。
リクエストが失敗した場合、基本の 1 クレジットは消費しません。ただし、検証成功時に消費した 2 クレジットは、その後の応答が失敗しても返還されません。
有効なセッションを再利用すると検証の繰り返しを減らせますが、成功したリクエストごとに 1 クレジットを消費します。セッション内の後続リクエストが無料になるわけではありません。
クレジットはプランの有効期限内にご利用ください。各プランの期限は個別に管理され、期限の近いクレジットから消費されます。
Cloudbypass API の仕組みは?
標準 HTTP リクエストと共通の連携ロジック・コードで Cloudflare と DataDome を処理し、既存の収集フレームワークをそのまま利用できます。プロキシ IP、Cookie、セッションを統一し、応答の状態と内容を確認してください。 対応可否は対象サイトと検証の種類によって異なります。事前に互換性をテストしてください。共通プランはすべての対象へのアクセスを保証するものではありません。
利用方法とコードサンプルはありますか?
Cloudflare と DataDome は同じ API 連携ロジックとリクエストコードを使用します。
対象サイトへ送信する HTTP リクエストをそのまま API に渡すだけで利用できます。リクエストは指定された x-cb-host に転送されます。
コードジェネレーター により、cURL / JavaScript / TypeScript / Java / Python 向けのサンプルコードを生成可能です。
API および Cloudbypass Proxy のサンプル:こちら
V1 と V2(s) の違いは?
V2(s) は JavaScript の実行(JS ポーリング)に対応します。
V2(s) にはデフォルトのプロキシが含まれないため、Cloudbypass Proxy の併用が必要です。V1 には動的プロキシが含まれています。
V2(s) のセッションパーティションとは?
Cloudflare Cookie を管理するための論理区分です。検証完了後、同一セッションが有効となり、プロキシ IP や指紋情報は 10 分間固定されます。これにより追加検証の発生を防ぎます。
パーティションは 0〜999 の範囲で最大 1,000 個利用可能。成功リクエストごとに有効時間は更新されます。
V1 / V2(s) のどちらを使うべきですか?
コードジェネレーターで対象 URL をテストし、まず V1 をお試しください。
V1 で通過しない場合は V2(s) を使用してください。V2(s) ではプロキシ設定が必要ですが、テスト用のプロキシトラフィックを提供しています。IP 抽出は 管理画面 から行えます。
最大同時リクエスト数は?
すべてのプランで最大 30 リクエスト / 秒です。
エラー:"CHALLENGE_LOCK_OCCUPIED"
同一 part が同時に使用されている状態です。
ロック解除を待つ、または part 値(0〜999)を変更してください。
エラー:"FORBIDDEN" / "V3 Challenge Failed"
IP 有効期間を 10 分以上に設定してください。
別の国・地域の IP に切り替えることで改善する場合があります。
403 / 503 / Access Denied が発生する場合
プロキシ設定が必要なケースです。API モードまたはプロキシモードのいずれかでご利用ください。現在は HTTP プロキシのみ対応しています。
Selenium / Puppeteer は使えますか?
対応していません。本サービスはブラウザを使用せず、ブラウザリクエストをエミュレートします。指紋ブラウザとの併用は可能です。
