getTaskResult: 获取任务结果
当通过 createTask 发起的任务是异步任务的时候，需要通过getTaskResult获取异步任务结果。
- 每个任务限制最多
120次查询请求，当超过查询请求后，任务结果会丢失 - 每个任务创建后
5分钟内可以查询，超过时间后会丢失 - 方法获取识别结果，根据系统负载，您将在
1s到30s的时间间隔内得到结果
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" //第一步createTask返回的结果
}参数结构
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| clientKey | string | 是 | 帐户密钥，可以在个人中心找到 |
| taskId | string | 是 | 通过创建任务 |
响应示例
{
"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了解出错误信息。🔗 点这里查看全部错误列表