導入ガイド

許可された CAPTCHA テストでの実践的な疑問：ポーリング、再試行、Cookie の一貫性と課金。

• Cloudflare Turnstile API 導入：許可されたテストの手順websiteURL と websiteKey を送信し、taskId を保存してトークンを取得。前提条件と公式テストキーとの違いを説明します。
• CAPTCHA ソルバーとは何か、いつ使うべきかソルバー API とブラウザー拡張・人手サービスの違い、許可されたテストでの適用範囲、事前に把握すべき限界を整理します。
• 非同期 CAPTCHA API を安全にポーリングする方法期限付きのループで待機中と uncertain を扱い、クライアントの期限後も同じタスクを照会する方法。
• CAPTCHA API の再試行で重複タスクを防ぐ方法タイムアウト後は同じ Idempotency-Key と本文を再利用。競合と再送可能期間、taskId の保存を解説します。
• CAPTCHA API の HTTP 402・429・503 エラー処理残高不足、レート制限、サービス障害を区別。Retry-After と固定の冪等キーで再試行を制御します。
• Cookie テストでプロキシと User-Agent を一致させる方法Cookie ベースのセッションでは同じ出口 IP と返却された useragent を使用し、再作成前に不一致を確認します。
• CAPTCHA API の費用管理：予約額・返金・再試行整数の USD micros で料金を確認し、予約額と成功タスクの課金、重複リクエストの費用を理解します。