查看来源

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

与 reCaptcha V2 不同在于，V3是无感识别，V3需要增加 pageAction 字段值（非必填）

创建任务

通过 createTask方法创建识别任务

请求节点： https://api.yescaptcha.com https://cn.yescaptcha.com

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

请求格式：POST application/json

对象结构

属性	类型	必须	说明
type	string	是	RecaptchaV3TaskProxyless RecaptchaV3TaskProxylessM1 RecaptchaV3TaskProxylessM1S7 强制分值0.7
websiteURL	string	是	ReCaptcha 网页地址，一般固定值。如何找到websiteURL值
websiteKey	String	是	ReCaptcha 网站密钥，固定值。如何找到websiteKey值
pageAction	String	是	此值必须正确，否则识别的结果无效。如何找reCaptchaV3的action值

请求示例

{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
    "task": {
        "websiteURL" : "https://www.toysrus.co.jp/member/CMmMemberForm.jsp",
        "websiteKey" : "6LdJXmobAAAAAFLNEpWqZrAXDr4I3l2lFyMLdqoM",
        "pageAction" : "homepage", // 有单独找action值的教程，看上面说明
        "type" : "RecaptchaV3TaskProxyless"
    }
}

响应示例

{
    "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 的时间间隔内得到结果

请求示例

{
    "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,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......"
    },
    "status": "ready"
}

响应说明

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

拓展：

reCaptcha其他type可选（使用以下type不需要另外指定minScore）：

RecaptchaV3TaskProxylessM1S7 强制minScore分值0.7

RecaptchaV3TaskProxylessM1S9 强制minScore分值0.9

常见问题：

1接口返回的结果不是100%都能验证成功，根据网站不同通过概率不同。
对方网站会设置一个分数要求，低于分数的就无法验证成功
对方网站会随时调高或降低分数
V3的要求高，如果你的网站有一点概率通过，就说明已经很不错了。
没有其他办法。