获取任务结果

captchaRun

461字约2分钟

2024-05-21

使用本接口轮询获取识别结果，可以通过status来检查是否完成了识别

建议用户设置查询间隔 3-5s 最多等待时间 3分钟, (超过3分钟识别成功不扣费)

重要

HCaptcha / ReCaptcha 识别成功后有效期约为2分钟，请尽快使用

重要

并不是所有的任务类型都需要使用本接口获取结果，具体请看对应任务类型的说明

请求方式: GET

路径: /v2/tasks/{taskId}

参数名	是否必填	说明
taskId	是	创建任务获取到的ID

请求样例

GET https://api.captcha.run/v2/tasks/3593b3cb-f196-486e-ac72-126c16017c1d // 创建任务获取的任务 ID

Authorization: Bearer 00000000-0000-0000-0000-000000000000 // 你的 Token

返回样例

{
    "status": "Success", // 状态, 参考下表
    "price": "0.008", // 价格
    "deducted": true, // 是否扣费
    "captchaType": "HCaptchaClassification", // 验证码类型
    "request": { ... }, // 请求参数, 参考具体任务类型
    "cache": false, // 是否使用了缓存
    "created": "2022-03-27T05:08:59.823Z", // 创建时间 (UTC)
    "finished": "2022-03-27T05:08:59.864Z", // 完成时间 (UTC)
    "response": { ... } // 识别结果, 参考具体任务类型
}

status	说明
Working	正在识别
Success	识别成功
Fail	识别失败请参考错误代码和说明

CURL代码

curl -H "Authorization: Bearer 00000000-0000-0000-0000-000000000000" https://api.captcha.run/v2/tasks/任务ID

Python代码

import requests

headers = {
    'Authorization': 'Bearer 00000000-0000-0000-0000-000000000000',
}

response = requests.get('https://api.captcha.run/v2/tasks/任务ID', headers=headers)