ガイド
タスクの結果を取得する:タスク結果

getTaskResult: タスク結果のリクエスト

createTask によって開始されたタスクが非同期タスクの場合、getTaskResult を使用して非同期タスクの結果を取得します。

  1. 各タスクのクエリリクエストの最大数は 120 です。クエリリクエストの数が超過すると、タスクの結果が失われます
  2. 各タスクは作成後 5 分以内にクエリでき、時間を超過すると失われます
  3. この方法で得られる認識結果は、システムの負荷に依存して、1 秒から 30 秒の時間間隔で結果が得られます。
WARNING

すべてのタスクがこの方法で結果を取得する必要はないことに注意してください。次の 2 つのタスクはドキュメントを確認する必要があります。

  • 同期的に直接 createTask によって返される、ImageToText などの識別クラスのタスクの結果

リクエストの例

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // createTask メソッドで作成された ID
}

リクエストパラメータ

パラメータタイプ必須説明
clientKeystringYesクライアントアカウントキー、こちら で見つけることができます
taskIdstringYescreateTask メソッド で作成された ID

レスポンスの例

{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

レスポンス構造

パラメータタイプ説明
errorIdIntegerエラーメッセージ:
0 - エラーなし
1 - エラーあり
errorCodeStringerrorCode: full list of errors
errorDescriptionStringエラーの説明
statusString• idle - 待機中
• processing - 識別中
• ready - 識別が完了し、結果は solution パラメータで見つかります
solutionObjectタスク結果データ。タスクの種類ごとに異なります

レスポンス仕様

  • 認識成功: errorId0statusready に等しい場合、結果は solution にあります。

  • 識別中: errorId0statusprocessing に等しい場合、3 秒後にもう一度試してください。

  • エラー: errorId0 より大きい場合、errorDescription に従ってエラー情報を確認してください。

    errorCode: full list of errors