getTaskResult: タスク結果のリクエスト
createTaskによって開始されたタスクが非同期タスクである場合、getTaskResultを通じて非同期タスクの結果を取得します。
- 各タスクのクエリリクエストの最大数は120です。クエリリクエストの数を超えると、タスクの結果は失われます。
- 各タスクは作成後5分以内にクエリ可能であり、時間を過ぎると失われます。
- この方法で得られる認識結果は、システム負荷に応じて、1秒から30秒の時間間隔で結果が得られます。
WARNING
すべてのタスクがこの方法で結果を取得する必要があるわけではないことに注意してください。以下の2つのタスクについては、ドキュメントを確認する必要があります。
- ImageToTextなどの識別クラスのタスクは、createTaskによって直接同期的に結果を返します。
リクエスト例
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey":"YOUR_API_KEY",
"taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" //ID created by the createTask method
}リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| clientKey | string | Yes | クライアントアカウントキー。これはこちらで確認できます。 |
| taskId | string | Yes | createTaskメソッドで作成されたID |
レスポンス例
{
"errorId": 0,
"taskId": "...",
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}レスポンス構造
| パラメータ | 型 | 説明 |
|---|---|---|
| errorId | Integer | エラーメッセージ： 0 - エラーなし 1 - エラーあり |
| errorCode | String | errorCode: エラーの全リスト |
| errorDescription | String | エラー説明 |
| status | String | • idle - 待機中 • processing - 認識中 • ready - 認識が完了し、結果はsolutionパラメータにあります |
| solution | Object | タスクの結果データ。タスクの種類ごとに異なります |
レスポンスの仕様
-
認識成功:
errorIdが0でstatusがreadyの場合、結果はsolutionにあります。 -
認識中:
errorIdが0でstatusがprocessingの場合、3秒後に再度お試しください。 -
エラー:
errorIdが0より大きい場合、errorDescriptionに従ってエラー情報を確認してください。