getTaskResult: 获取任务结果
当通过 createTask 发起的任务是异步任务的时候,需要通过getTaskResult获取异步任务结果。
- 每个任务限制最多
120次查询请求,当超过查询请求后,任务结果会丢失 - 每个任务创建后
5分钟内可以查询,超过时间后会丢失 - 方法获取识别结果,根据系统负载,您将在
1s到30s的时间间隔内得到结果
WARNING
注意不是所有任务都需要通过这种方式拿取结果,以下2种方式需要单独查询文档查看结果获取方式
- 识别类任务,例如ImageToText等,是同步直接通过createTask返回结果
请求示例
json
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返回的结果
}参数结构
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| clientKey | string | 是 | 帐户密钥,可以在个人中心找到 |
| taskId | string | 是 | 通过创建任务 |
响应示例
json
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}响应数据
| 参数 | 类型 | 说明 |
|---|---|---|
| errorId | Integer | 错误提示: 0 - 没有错误,1 - 有错误 |
| errorCode | String | 错误代码对照表 |
| errorDescription | String | 错误详细描述 |
| status | String | • idle - 等待调度中 • processing - 正在识别中 • ready - 识别完成,在solution参数中找到结果 |
| solution | Object | 识别结果,不同类型的任务结果会有所区别。 |
响应说明
- 识别成功:当
errorId等于0并且status等于ready,结果在solution里面。 - 正在识别中:当
errorId等于0并且status等于processing,请3秒后重试。 - 出错了:当
errorId大于0,请根据errorDescription了解出错误信息。🔗 点这里查看全部错误列表
CapSolver