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
获取错误信息。