CapMonster Cloud APIによる自動CAPTCHA認識
CapMonster Cloud APIを使用したCAPTCHA認識は、プログラミングインターフェースを介して単語や記号を認識し解決する自動化されたプロセスです。CapMonster Cloudを使用すれば、CAPTCHAのバイパスを自動化して、ワークフローを簡素化・高速化できます。
仕組み
APIは以下のプロセスでCAPTCHAを解決します：
1. リクエストの送信
クライアントはCAPTCHAデータ（画像、サイトキー、URL）を含むリクエストをAPIサーバーに送信します。
2. 処理
APIサーバーがリクエストを処理し、CAPTCHAを認識して解決を開始します。
3. 解決結果の受信
APIサーバーがCAPTCHAを解決し、クライアントは認証を継続できます。
なぜCAPTCHA解決にAPIを使うのか
API（アプリケーション・プログラミング・インターフェース）はWebサイト上の動作を自動化します。
登録フォームの入力
データの抽出とコピー
さまざまな情報をサーバーに送信
APIによる自動CAPTCHA解決
CapMonster Cloud APIは、JSON形式のデータを含む標準HTTPリクエストを使用します。
APIアドレス
- createTaskCAPTCHA解決タスクを作成します。JSON POST
https://api.capmonster.cloud/createTask - getTaskResultタスクの状態を確認し、結果を取得します。JSON POST
https://api.capmonster.cloud/getTaskResult - getBalance現在のアカウント残高を取得します。JSON POST
https://api.capmonster.cloud/getBalance - getUserAgent最新のブラウザおよびOS情報を提供します。JSON POST
https://capmonster.cloud/api/useragent/actual
キャプチャ解決アルゴリズム
タスク作成のためのリクエスト送信
以下のアドレスにHTTP POSTリクエストを送信してください：
https://api.capmonster.cloud/createTaskリクエストにAPIキーとタスクの詳細を含めてください。
リクエストは以下のように見えるはずです：
{
"clientKey":"API_KEY",
"task": {
"type":"RecaptchaV2TaskProxyless",
"websiteURL":"https://example.com/",
"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
}
}サーバーはキャプチャの識別子（taskId）または何か問題があった場合はエラーコードを返します。
レスポンスの取得タスクを作成した後、以下のアドレスにレスポンスを取得するためのリクエストを送信してください：
https://api.capmonster.cloud/getTaskResultAPIキーとタスク識別子（taskId）を含めてください。
リクエストは以下のように見えるはずです：
{
"clientKey":"API_KEY",
"taskId":12345678
}サーバーはキャプチャを解決するか、タスクがまだ進行中である情報を提供します。
レスポンスの例：
{
"errorId":0,
"status":"ready",
"solution": {
"gRecaptchaResponse":"response_token"
}
}エラー処理：主な種類とトラブルシューティングの手順
遭遇する可能性のある主なエラー：
INVALID KEY
APIエラーコード： ERROR_KEY_DOES_NOT_EXIST
この通知は、入力したAPIキーが間違っているか存在しないことを示します。正しく入力したか確認し、再度試してください。
NO FUNDS
APIエラーコード： ERROR_ZERO_BALANCE
この通知は、タスクを完了するための十分な資金がないことを示します（つまり、残高がゼロです）。解決を続けるためにアカウントにチャージしてください。
BIG IMAGE SIZE
APIエラーコード： ERROR_TOO_BIG_CAPTCHA_FILESIZE
この通知は、キャプチャのサイズが制限を超えていることを示します。
ZERO IMAGE SIZE
APIエラーコード： ERROR_ZERO_CAPTCHA_FILESIZE
この通知は、アップロードしているキャプチャのサイズが100バイト未満であることを示します。
CAPTCHA ID IS NOT FOUND
APIエラーコード： ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID
キャプチャがシステム内で見つかりませんでした（そのIDを特定できませんでした）。キャプチャのステータスは提出後最初の5分以内に確認する必要があります。この時間枠内で確認してください。
CAPTCHA UNSOLVABLE
APIエラーコード： ERROR_CAPTCHA_UNSOLVABLE
このタイプのキャプチャはサービスでサポートされていません、または画像に読み取れる回答が含まれていないため、ノイズである可能性があります。画像が破損しているか、正しくレンダリングされていない可能性があります。
CAPTCHA IS NOT READY
APIエラーコード： CAPTCHA_NOT_READY
キャプチャはまだ解決されていません。1～2分待ってください。
REQUEST IS NOT ALLOWED FROM YOUR IP
APIエラーコード： ERROR_IP_NOT_ALLOWED
この通知は、このIPアドレスからのリクエストが拒否されたことを示します。個人アカウントの設定を開き、IPを許可リストに追加してください。
IP BANNED
APIエラーコード： ERROR_IP_BANNED
間違ったAPIキーでリクエスト制限を超えました。キーを確認し、タスクを再度作成してみてください。
INCORRECT METHOD
APIエラーコード： ERROR_NO_SUCH_METHOD
キャプチャのタイプ（「type」パラメータの値）が正しくありません。使用したメソッドの正確さを確認してください。
THE TOKEN IS EXPIRED
APIエラーコード： ERROR_TOKEN_EXPIRED
キャプチャの認識中に、プロバイダーが追加トークンの有効期限が切れていることに気づきました。新しいタスクを作成し、新しいトークンを取得して、リクエストを再度試してください。
NO FREE SERVERS
APIエラーコード： ERROR_NO_SLOT_AVAILABLE
すべてのサーバーがビジーです。後で再度試してください。
INVALID RECAPTCHA SITEKEY
APIエラーコード： ERROR_RECAPTCHA_INVALID_SITEKEY
誤ったreCAPTCHAキーが提供されました。サイトキーの正確さを確認してください。
RECAPTCHA TIMEOUT
APIエラーコード： ERROR_RECAPTCHA_TIMEOUT
この通知は、reCAPTCHAを解決するための実行時間がサーバーで設定された許容時間を超え、タスクが指定された時間枠内で完了できないことを示します。後でリクエストを再度送信してみてください。
YOUR IP IS BLOCKED
APIエラーコード： ERROR_IP_BLOCKED
指定されたIPアドレスからのアクセスは、多数のエラーのため禁止されています。リクエストの頻度を確認してください。IPを変更してください。タスク作成時の制限を考慮してください。
FAILED TO CONNECT PROXY
APIエラーコード： ERROR_PROXY_CONNECT_REFUSED
サービスは指定されたプロキシサーバーを通じて接続を確立できません。プロキシ設定（IP、ポート、ログイン、パスワード）の正確さと可用性を確認してください。別のものを使用してください。
THE PROXY IP IS BANNED
APIエラーコード： ERROR_PROXY_BANNED
プロキシは、対象のキャプチャサービスでそのIPによって禁止されています。別のものを使用してください。
ERROR_TASK_ABSENT
APIエラーコード： ERROR_TASK_ABSENT
タスクオブジェクトが見つからなかったか、無効なJSONが送信されました。すべてが正しいことを確認してください。タスクの実行時間が期限切れになっていないか確認してください。
最新のAPIパラメータとメソッドのみを使用するために、常にドキュメントを参照してください。
重要！別のエラーに遭遇し、解決方法がわからない場合？以下のガイドを参照して問題を解決してください： https://docs.capmonster.cloud/docs/api/api-errors/。