页面比较

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

信息
只有目标网站使用了企业版reCaptcha，我们才能使用企业版接口去识别….

...

信息

企业V2目前通过较为困难，如果本接口不能通过验证，建议了解（有一定技术难度）

ReCaptchaV2Classification: reCaptcha V2 图像识别

说明
STEAM无法通过此接口识别，请使用图像识别接口，或者使用基于图像识别接口开发的软件，价格可咨询客服。

创建任务

通过 createTask方法创建识别任务

请求节点：

状态

colour	Green
title	国际节点

https://api.yescaptcha.com

状态

colour	Green
title	国内节点

https://cn.yescaptcha.com

...

请求格式：POST application/json

对象结构

属性

类型

必须

说明

type

string

是

RecaptchaV2EnterpriseTaskProxyless

状态

colour	Green
title	20 POINTS

状态

colour	Yellow
title	插件默认

websiteURL

string

是

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

websiteKey

String

是

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

enterprisePayload

Object

否

附加参数s，可在在下方代码中找到：

代码块
grecaptcha.enterprise.render( render_div_id, { 'sitekey': sitekey, 'theme': 'dark', 'callback': function(n){}, 's': "2JvUXHNTnZl1Jb6WEvbDyBMzrMTR7oQ78QRhBcG07rk9bpaAaE0LRq1ZeP5NYa0N...ugQA" });

请求示例

代码块

language	json

{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
    "task": {
		"websiteURL": "https://store.steampowered.com/",
		"websiteKey": "6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH",
		"type": "RecaptchaV2EnterpriseTaskProxyless",
		"enterprisePayload": {
                "s": "2JvUXHNTnZl1Jb6WEvbDyBMzrMTR7oQ78QRhBcG07rk9bpaAaE0LRq1ZeP5NYa0N..."  
      }
    }
}

响应示例

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

获取结果

使用 getTaskResult 方法获取识别结果。

请求节点：

状态

colour	Green
title	国际节点

https://api.yescaptcha.com

状态

colour	Green
title	国内节点

https://china.yescaptcha.com

...

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

请求示例

代码块
{ "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通过验证

响应示例

代码块

language	json

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......"
    },
    "status": "ready"
}

...

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

版本比较

旧版本 1

新版本 2

密钥

创建任务

对象结构

请求示例

响应示例

获取结果

请求示例

响应结果

响应示例