ReCaptcha V2 任务

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

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

立即查看在线代码示例！

任务类型

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

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

任务类型	描述	价格	价格(美元)
ReCaptchaV2TaskProxyless	reCaptcha V2解决方案，使用服务器内置代理	6 POINTS	$0.6/1k
ReCaptchaV2TaskProxylessS9	reCaptcha V2高分值解决方案，使用服务器内置代理并使得返回的token分数至少为0.9	12 POINTS	$1.2/1k
ReCaptchaV2STaskProxyless	reCaptcha V2带s参数解决方案，使用服务器内置代理	6 POINTS	$0.6/1k
ReCaptchaV2EnterpriseTaskProxyless	reCaptcha V2Enterprise解决方案，使用服务器内置代理	12 POINTS	$1.2/1k
ReCaptchaV2SEnterpriseTaskProxyless	reCaptcha V2Enterprise带s参数解决方案，使用服务器内置代理	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

对象结构

属性	类型	必须	说明

属性	类型	必须	说明
clientKey	string	是	您账号的用户密钥
type	string	是	任务类型，例如 ReCaptchaV2TaskProxyless
websiteURL	string	是	ReCaptcha 网页地址，一般固定值。
websiteKey	string	是	ReCaptcha 网站密钥，固定值。
isInvisible	Bool	否	遇到invisible类型的reCaptchaV2需要添加此参数并设置为true，该参数不填时默认为false
sa	string	否	如果sa出现在anchor请求的查询参数中，您将需要设置该值为sa查询参数的值，它通常是一个字符串。注意：有部分网站可能会严格校验该值
s	string	否	用于解决带s参数的reCaptcha V2，包括V2和V2 Enterprise，需要将类型指定为ReCaptchaV2STaskProxyless或RecaptchaV2SEnterpriseTaskProxyless，从你所使用的网站中返回的数据包中找到该参数并设置
websiteTitle	string	可选	加载recaptcha的网站页面，使用js控制台运行“document.title”获取title

请求示例

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

Content-Type: application/json

{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
    "task": {
        "websiteURL": "https://www.google.com/recaptcha/api2/demo",
        "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
        "type": "ReCaptchaV2TaskProxyless",
        "isInvisible": false // invisable类型的reCaptchaV2设置添加true
    }
}

响应示例

{
    "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 到 60s 的时间间隔内得到结果，120秒超时

请求示例

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 - 正在识别中，请3秒后重试 ready - 识别完成，在solution参数中找到结果
solution	Object	识别结果，不同类型的captcha的结果会有所区别，对于reCaptcha而言，结果为对象中的gRecaptchaResponse。
solution.gRecaptchaResponse	string	识别结果：response值，用于POST或模拟提交给目标网站。一次性使用，有效期120s，建议在60s内使用。

响应示例

响应说明

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