HCaptcha 任务(维护中,不可使用)
通过 createTask方法 创建识别任务,然后通过 getTaskResult 方法 获取识别结果
如果你获得了无效的token,请联系我们,通常在我们优化之后都可以正常工作
任务类型
任务类型 | 描述 | 价格 | 价格(美元) |
---|---|---|---|
HcaptchaTaskProxyless | HCaptcha 解决方案,使用服务器内置代理 | 9 POINTS | $0.9/1k |
创建任务
通过 createTask方法 创建识别任务
请求节点: https://api.ez-captcha.com
请求地址: https://api.ez-captcha.com/createTask
中国优化地址:http://47.115.166.118:15000/createTask
请求格式:POST
application/json
对象结构
属性 | 类型 | 必须 | 说明 |
---|---|---|---|
clientKey | string | 是 | 您账号的用户密钥 |
type | string | 是 | 任务类型: HcaptchaTaskProxyless |
websiteURL | string | 是 | 使用HCaptcha的网页地址,一般固定值。 |
websiteKey | string | 是 | 使用HCaptcha网站密钥,固定值。 |
enterprisePayload | object | 否 | HCaptcha企业版额外参数,目前仅支持rqdata (beta版本):
|
isInvisible | Bool | 否 | HCaptcha类型是否为invisible |
请求示例
POST https://api.ez-captcha.com/createTask
Content-Type: application/json
{
"clientKey": "7e5ffc29e3354a19991002f2a19978bb696679",
"task": {
"websiteURL": "https://discord.com/register",
"websiteKey": "4c672d35-0701-42b2-88c3-78380b0db560",
"type": "HcaptchaTaskProxyless"
}
}
响应示例
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID
}
获取结果
使用 getTaskResult 方法获取识别结果
请求节点: https://api.ez-captcha.com
请求地址: https://api.ez-captcha.com/getTaskResult
中国优化地址:http://47.115.166.118:15000/getTaskResult
请求格式:POST
application/json
根据系统负载,您将在大约 10s 到 20s 的时间间隔内得到结果
请求示例
POST https://api.ez-captcha.com/getTaskResult
Content-Type: application/json
{
"clientKey":"YOUR_API_KEY",
"taskId": "TASKID OF CREATETASK" //由createTask方法创建的ID
}
响应结果
参数 | 类型 | 说明 |
---|---|---|
errorId | Integer | 错误提示: 0 - 没有错误,1 - 有错误 |
errorCode | string | 错误代码, 点这里查看全部错误列表 |
errorDescription | string | 错误详细描述 |
status | String | processing - 正在识别中,请1秒后重试 |
solution | Object | 识别结果,不同类型的captcha的结果会有所区别,对于HCaptcha而言,结果为对象中的token。 |
solution.token | string | 识别结果:token值,用于POST或模拟提交给目标网站。 一次性使用,建议获取后立即使用。 |
响应示例
响应说明
识别成功:当
errorId
等于0
并且status
等于ready
,结果在solution
里面。正在识别中:当
errorId
等于0
并且status
等于processing
,请1秒后重试。出错了:当
errorId
大于0
,请根据errorDescription
了解出错误信息 全部错误说明