NoCaptchaTaskProxyless : reCaptcha V2 协议接口

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

此对象用于识别reCaptchaV2版本

创建任务

通过 createTask方法 创建识别任务

请求节点: 国际节点 https://api.yescaptcha.com 国内节点 https://cn.yescaptcha.com

请求地址: https://api.yescaptcha.com/createTask

请求格式:POST application/json

对象结构

属性

类型

必须

说明

属性

类型

必须

说明

type

string

NoCaptchaTaskProxyless 15 POINTS 插件默认

RecaptchaV2TaskProxyless 18 POINTS ->20 POINTS 质量更好,更稳定。

websiteURL

string

ReCaptcha 网页地址,一般固定值。 如何找到websiteURL值

websiteKey

String

ReCaptcha 网站密钥,固定值。 如何找到websiteKey值

isInvisible

Bool

遇到isInvisible类型的reCaptchaV2需要添加此参数 如何判断 reCaptcha 是什么版本

请求示例

{ "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f", "task": { "websiteURL": "https://www.google.com/recaptcha/api2/demo", "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", "type": "NoCaptchaTaskProxyless", "isInvisible": false // isinvisable类型才需要添加 true 值 } }

响应示例

{ "errorId": 0, "errorCode": "", "errorDescription": "", "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // 请记录此ID }

获取结果

使用 getTaskResult 方法获取识别结果

请求节点: 国际节点 https://api.yescaptcha.com 国内节点 https://china.yescaptcha.com

请求地址: https://api.yescaptcha.com/getTaskResult

请求格式:POST application/json

根据系统负载,您将在 10s 到 80s 的时间间隔内得到结果,120秒超时

请求示例

{ "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内使用。 了解如何使用response通过验证

响应示例

 

响应说明

  • 识别成功:当errorId等于0 并且status等于 ready,结果在solution里面。

  • 正在识别中:当errorId等于0 并且status等于 processing,请3秒后重试。

  • 出错了:当errorId 大于0,请根据errorDescription了解出错误信息 全部错误说明

 

常见问题:

  1. 接口返回的结果不是100%都能验证成功,根据网站不同通过概率不同。

  2. 对方网站会设置一个分数要求,低于分数的就无法验证成功

  3. 对方网站会随时调高或降低分数

  4. 如果你的网站有一点概率通过,就说明已经很不错了。

  5. V2可以改用图像识别接口或者使用基于图像识别接口开发的付费插件,图片点完100%通过