getTaskResult: タスク結果のリクエスト
createTask によって開始されたタスクが非同期タスクの場合、getTaskResult を使用して非同期タスクの結果を取得します。
- 各タスクのクエリリクエストの最大数は 120 です。クエリリクエストの数が超過すると、タスクの結果が失われます
- 各タスクは作成後 5 分以内にクエリでき、時間を超過すると失われます
- この方法で得られる認識結果は、システムの負荷に依存して、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
}リクエストパラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| clientKey | string | Yes | クライアントアカウントキー、こちら で見つけることができます |
| taskId | string | Yes | createTask メソッド で作成された ID |
レスポンスの例
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}レスポンス構造
| パラメータ | タイプ | 説明 |
|---|---|---|
| errorId | Integer | エラーメッセージ： 0 - エラーなし 1 - エラーあり |
| errorCode | String | errorCode: full list of errors |
| errorDescription | String | エラーの説明 |
| status | String | • idle - 待機中 • processing - 識別中 • ready - 識別が完了し、結果は solution パラメータで見つかります |
| solution | Object | タスク結果データ。タスクの種類ごとに異なります |
レスポンス仕様
-
認識成功:
errorIdが0でstatusがreadyに等しい場合、結果はsolutionにあります。 -
識別中:
errorIdが0でstatusがprocessingに等しい場合、3 秒後にもう一度試してください。 -
エラー:
errorIdが0より大きい場合、errorDescriptionに従ってエラー情報を確認してください。