| 说明 |
|---|
通过 createTask方法 创建识别任务，然后通过 getTaskResult 方法 获取识别结果 |
| 信息 |
|---|
此对象用于识别reCaptchaV2版本 |
创建任务
通过 createTask方法 创建识别任务
请求节点：
| 状态 | ||||
|---|---|---|---|---|
|
https://api.yescaptcha.com | 状态 | ||||
|---|---|---|---|---|
|
https://cn.yescaptcha.com...
请求格式：POST application/json
对象结构
属性 | 类型 | 必须 | 说明 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type | string | 是 | NoCaptchaTaskProxyless
RecaptchaV2TaskProxyless
| ||||||||||||||||||||||||||||
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...
根据系统负载，您将在 10s 到 80s 的时间间隔内得到结果，120秒超时
请求示例
| 代码块 |
|---|
{
"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,
"errorCode": null,
"errorDescription": null,
"solution": {
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......"
},
"status": "ready"
} |
...
识别成功：当
errorId等于0并且status等于ready，结果在solution里面。正在识别中：当
errorId等于0并且status等于processing，请3秒后重试。出错了：当
errorId大于0，请根据errorDescription了解出错误信息 🔗 全部错误说明
常见问题：
| 展开 | ||
|---|---|---|
| ||
|