RecaptchaV3TaskProxyless: reCaptcha V3 协议接口
- YesCaptcha ADMIN
通过 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 | 是 | RecaptchaV3TaskProxylessK1 20 POINTS 新类型公测 RecaptchaV3EnterpriseTaskProxylessK1 25 POINTS 企业v3 新类型公测 RecaptchaV3TaskProxyless 20 POINTS RecaptchaV3TaskProxylessM1 25 POINTS 以上type只是架构不同，您可以测试您的业务通过率，根据需要自行选择 另外如果遇到故障也可以临时切换用于备用 |
websiteURL | string | 是 | ReCaptcha 网页地址，一般固定值。 如何找到websiteURL值 |
websiteKey | String | 是 | ReCaptcha 网站密钥，固定值。 如何找到websiteKey值 |
pageAction | String | 是 | 此值必须正确，否则识别的结果无效。 https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/57573377 |
请求示例
{
"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秒后重试 |
solution | Object | 识别结果，不同类型的任务结果会有所区别。 |
gRecaptchaResponse | string | 识别结果：response值，用于POST或模拟提交给目标网站。 一次性使用，有效期120s，建议在60s内使用。 了解如何使用response通过验证 |
响应示例
响应说明
识别成功：当
errorId等于0并且status等于ready，结果在solution里面。正在识别中：当
errorId等于0并且status等于processing，请3秒后重试。出错了：当
errorId大于0，请根据errorDescription了解出错误信息 全部错误说明
拓展：
reCaptcha其他type可选（使用以下type不需要另外指定minScore）：
RecaptchaV3TaskProxylessM1S730 points 强制minScore分值0.7
RecaptchaV3TaskProxylessM1S935 points 强制minScore分值0.9
常见问题：