getTaskResult: 请求任务结果
当通过 createTask 启动的任务是异步任务时，通过 getTaskResult 获取异步任务结果。
- 每个任务的最大查询请求次数为 120 次。当查询请求次数超出时，任务结果将丢失。
- 每个任务在创建后 5 分钟内可进行查询，超时后将丢失。
- 通过此方法获取的识别结果，根据系统负载情况，您将在 1 秒至 30 秒的时间间隔内获得结果。
WARNING
请注意，并非所有任务都需要通过这种方式获取结果。以下两种任务需要查看文档。
- 识别类任务，如 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 | 是 | 客户端账户密钥，可在此处查找 此处 |
| taskId | string | 是 | 通过 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获取错误信息。