/
NoCaptchaTaskProxyless : reCaptcha V2 协议接口

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 20 POINTS

RecaptchaV2TaskProxylessK1 20 POINTS 定制类型,使用前请联系客服定制

  • 以上type只是架构不同,您可以测试您的业务通过率,根据需要自行选择

  • 另外如果遇到故障也可以临时切换用于备用

  • 如果遇到无法通过的网站,请联系客服为您定制

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%通过

Related content

RecaptchaV3TaskProxyless: reCaptcha V3 协议接口
RecaptchaV3TaskProxyless: reCaptcha V3 协议接口
More like this
RecaptchaV2EnterpriseTaskProxyless: 企业版 reCaptcha V2
RecaptchaV2EnterpriseTaskProxyless: 企业版 reCaptcha V2
More like this
YesCaptcha API 开发文档
YesCaptcha API 开发文档
More like this
如何通过API来通过 reCaptcha
如何通过API来通过 reCaptcha
More like this
如何找到 reCaptcha 需要的各项参数
如何找到 reCaptcha 需要的各项参数
Read with this
NoCaptchaTaskProxyless: reCaptcha V2 protocol interface
NoCaptchaTaskProxyless: reCaptcha V2 protocol interface
More like this