仕組みなぜCAPTCHA解決にAPIを使うのか APIによる自動CAPTCHA解決エラー処理：主な種類とトラブルシューティングの手順

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アドレス

createTask
CAPTCHA解決タスクを作成します。
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
```

キャプチャ解決アルゴリズム

キーの取得

まず、 CapMonster Cloudの個人ダッシュボードで一意のAPIキーを取得してください。。

タスク作成のためのリクエスト送信

以下のアドレスに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/getTaskResult

APIキーとタスク識別子（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が送信されました。すべてが正しいことを確認してください。タスクの実行時間が期限切れになっていないか確認してください。

重要！別のエラーに遭遇し、解決方法がわからない場合？以下のガイドを参照して問題を解決してください： https://docs.capmonster.cloud/docs/api/api-errors/。