ReCaptcha V3 任务

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

如果你获得了无效的token,请联系我们,通常在我们优化之后都可以正常工作

立即查看在线代码示例！

任务类型

对于ReCaptcha V3的解决方案，我们提供的任务类型如下：

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

任务类型	描述	价格	价格(美元)
ReCaptchaV3TaskProxyless	reCaptcha V3解决方案，使用服务器内置代理	8 POINTS	$0.8/1k
ReCaptchaV3TaskProxylessS9	reCaptcha V3高分值解决方案，使用服务器内置代理并使得返回的token分数至少为0.9	12 POINTS	$1.2/1k
ReCaptchaV3EnterpriseTaskProxyless	reCaptcha V3Enterprise解决方案，使用服务器内置代理	12 POINTS	$1.2/1k

创建任务

通过 createTask方法创建识别任务

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

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

中国优化地址：http://47.115.166.118:15000/createTask

请求格式：POST application/json

对象结构

注意：某些网站可能需要ua匹配，请直接使用我们指纹所用的ua，一般我们会跟随chrome版本进行更新

user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36

sec-ch-ua: "Chromium";v="128", "Not;A=Brand";v="24", "Google Chrome";v="128"

属性	类型	必须	说明

属性	类型	必须	说明
clientKey	string	是	帐户密钥，可以在个人中心找到
task	object	是	任务参数对象，详情为表格以下几项
type	string	是	任务类型，如 ReCaptchaV3TaskProxyless
websiteURL	string	是	ReCaptcha 网页地址，一般固定值
websiteKey	String	是	ReCaptcha 网站密钥，固定值
isInvisible	Bool	可选	对于reCaptcha V3类型，该参数一般都为true，如果用户不提供，则默认自动设置为true
pageAction	String	可选	此值必须正确，否则识别的结果大概率无效
websiteTitle	string	可选	加载recaptcha的网站页面，使用js控制台运行“document.title”获取title
checkField	string	可选	reload 包中 protobuf 9的新值，可进行二次验证

请求示例

不要直接拿示例里面的pageAction来用！每个站的pageAction都不一样，参考此文章查找，传错了过不了！

POST https://api.ez-captcha.com/createTask
Content-Type: application/json

{
    "clientKey": "your clientkey",
    "task": {
        "websiteURL": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
        "websiteKey": "6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696",
        "type": "ReCaptchaV3TaskProxyless",
        "isInvisible": true,
        "pageAction": "examples/v3scores"
    }
}

响应示例

{
    "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

根据系统负载，您将在 1s 到 10s 的时间间隔内得到结果

请求示例

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

Content-Type: application/json

{
    "clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f3",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

响应结果

参数	类型	说明

参数	类型	说明
errorId	Integer	错误提示： 0 - 没有错误，1 - 有错误
errorCode	string	错误代码，点这里查看全部错误列表
errorDescription	string	错误详细描述
status	String	processing - 正在识别中，请3秒后重试 ready - 识别完成，在solution参数中找到结果
solution	Object	识别结果，不同类型的任务结果会有所区别。
gRecaptchaResponse	string	识别结果：response值，用于POST或模拟提交给目标网站。一次性使用，有效期120s，建议在60s内使用。

响应示例

响应说明

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