通过 createTask方法 创建识别任务,然后通过 getTaskResult 方法 获取识别结果 |
此对象用于识别reCaptchaV2版本 |
通过 createTask方法 创建识别任务
请求节点: https://api.yescaptcha.com
https://cn.yescaptcha.com
请求地址: https://api.yescaptcha.com/createTask
请求格式: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
请求地址: 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秒后重试 |
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
了解出错误信息 全部错误说明
常见问题:
|