HCaptcha 任务

通过 createTask方法创建识别任务，然后通过 getTaskResult 方法获取识别结果

任务类型

任务类型	描述	价格(美元)

任务类型	描述	价格(美元)
HCaptcha	HCaptcha 解决方案	$3.0/k

创建任务

通过以下方法创建任务

请求host： https://api.ez-captcha.com

请求api： https://api.ez-captcha.com/createTask

请求format：POST application/json

备注

目前仅支持的浏览器版本为：Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36
代理仅支持美国地区的住宅代理。

参数

参数	类型	是否必须	描述

参数	类型	是否必须	描述
clientKey	string	yes	你的clientkey
type	string	yes	HCaptcha
websiteURL	string	yes	网站url
proxy	string	no	使用的代理，如`http://username:password@ip:port` 目前仅支持美国地区的住宅代理。
websiteKey	string	yes	网站的 websiteKey
lang	string	yes	目前仅支持 en-US
invisible	boolean	yes	如未显示 hcap 勾选框，则填写“true”；若已显示，则填写“false”
rqdata	string	no	如果网站中有，则需要填写

示例

POST https://api.ez-captcha.com/createTask

Content-Type: application/json

{
    "clientKey": "YourClientKey",
    "task": {
        "websiteURL": "https://xxx.com",
        "type": "HCaptcha",
        "proxy": "http://username:password@ip:port",
        "lang": "en-US",
        "websiteKey": "e94865c2-4231-4c25-9c6e-2b797b2b56cf",
        "invisible": false
    }
}

返回示例

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // Please save this ID for next step
}

获取结果

使用 getTaskResult 方法获取结果

请求 host： https://api.ez-captcha.com

请求 api： https://api.ez-captcha.com/getTaskResult

请求 format：POST application/json

请求示例

POST https://api.ez-captcha.com/getTaskResult

Content-Type: application/json
 
{
    "clientKey":"YOUR_API_KEY",
    "taskId": "TASKID OF CREATETASK" //ID created by createTask method
}

返回参数

参数	类型	描述

参数	类型	描述
errorId	Integer	错误提示： 0 - 没有错误，1 - 有错误
errorCode	string	错误代码，点这里查看全部错误列表
errorDescription	string	错误详细描述
status	String	processing - 正在识别中，请3秒后重试 ready - 识别完成，在solution参数中找到结果
solution	Object	识别结果，不同类型的任务结果会有所区别。

返回示例

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
      "generated_pass_UUID": "xxxxxx",
      "lang": "en-US",
      "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36"
    },
    "status": "ready"
}

响应说明

识别成功：当errorId等于0 并且status等于 ready，结果在solution里面。
正在识别中：当errorId等于0 并且status等于 processing，请1-3秒后重试。
出错了：当errorId 大于0，请根据errorDescription了解出错误信息全部错误说明