Skip to content
On this page
Home
>API接口
>getTaskResult:获取结果

getTaskResult: 获取任务结果

当通过 createTask 发起的任务是异步任务的时候,需要通过getTaskResult获取异步任务结果。

  1. 每个任务限制最多 120 次查询请求,当超过查询请求后,任务结果会丢失
  2. 每个任务创建后 5分钟 内可以查询,超过时间后会丢失
  3. 方法获取识别结果,根据系统负载,您将在 1s30s 的时间间隔内得到结果

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返回的结果
}

参数结构

参数类型必须说明
clientKeystring帐户密钥,可以在个人中心找到
taskIdstring通过创建任务

响应示例

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

响应数据

参数类型说明
errorIdInteger错误提示: 0 - 没有错误,1 - 有错误
errorCodeString错误代码对照表
errorDescriptionString错误详细描述
statusString• idle - 等待调度中
• processing - 正在识别中
• ready - 识别完成,在solution参数中找到结果
solutionObject识别结果,不同类型的任务结果会有所区别。

响应说明

  • 识别成功:当errorId等于0 并且status等于 ready,结果在solution里面。
  • 正在识别中:当errorId等于0 并且status等于 processing,请3秒后重试。
  • 出错了:当errorId 大于0,请根据errorDescription 了解出错误信息。🔗 点这里查看全部错误列表