指南
getTaskResult: 任务结果

getTaskResult: 请求任务结果

当通过 createTask 启动的任务是异步任务时,通过 getTaskResult 获取异步任务结果。

  1. 每个任务的最大查询请求次数为 120 次。当查询请求次数超出时,任务结果将丢失。
  2. 每个任务在创建后 5 分钟内可进行查询,超时后将丢失。
  3. 通过此方法获取的识别结果,根据系统负载情况,您将在 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
}

请求参数

参数类型必填描述
clientKeystring客户端账户密钥,可在此处查找 此处
taskIdstring通过 createTask 方法 创建的 ID

响应示例

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

响应结构

参数类型描述
errorIdInteger错误信息:
0 - 无错误
1 - 有错误
errorCodeStringerrorCode:错误代码完整列表
errorDescriptionString错误描述
statusString• idle - 等待中
• processing - 正在识别
• ready - 识别完成,结果在 solution 参数中
solutionObject任务结果数据。每种任务类型都不同

响应说明

  • 识别成功: 当 errorId 等于 0status 等于 ready 时,结果在 solution 中。

  • 正在识别: 当 errorId 等于 0status 等于 processing 时,请在 3 秒后重试。

  • 错误: 当 errorId 大于 0 时,请根据 errorDescription 获取错误信息。

    errorCode:错误代码完整列表