reCAPTCHA识别 谷歌人机验证识别接口

Google reCAPTCHA V2/V3/Enterprise 自动识别

请求参数

参数位置必填
keyheaderkey
typeurlreCAPTCHA类型:v2/v3/enterprise
sitekeyurlsitekey
urlurl页面链接
reCAPTCHA所在页面链接
如:https://www.google.com/
invisibleurl0=>非隐形、1=>隐形,默认为0 (v2)
actionurl页面动作 (v3)
grecaptcha.execute 中的 action 动作
minscoreurl最低分数:0.1-0.9 (v3)

invisible for v2
action/minscore for v3

隐形reCAPTCHA invisible=1 for v2

通常不会在页面显示 I'm not robot 选项,它会在页面加载或用户操作(如:点击按钮或提交表单)时激活,具体取决于网站。
如果用户的 Cookie 足够好,那么将自动通过,否则,用户将看到带有挑战的标准reCAPTCHA表格。
在大多数情况下,完成挑战后,将执行回调函数(callback)。

区分V3

https://www.google.com/recaptcha/api.js?render=6LdpS-gUAAAAAL3Qr2yP7rkrQjkKBVvEY_48JS5l
V3:render=sitekey
grecaptcha.execute('6LdpS-gUAAAAAL3Qr2yP7rkrQjkKBVvEY_48JS5l', {action: 'login'}).then(function(response) {});
V3:包含 action 动作
V3:通常为隐形(提交后才会显示reCAPTCHA)

最低分数 minscore for v3

对于reCAPTCHA V3,你需要了解解决V3所需的分数(score)。
你无法预测要解决的网站可接受的分数,只能通过反复试验才能弄清楚。
最低分数是0.1,表示“机器人”,最高分数是0.9,表示“人”,大多数网站使用的阈值范围是0.2到0.5,因为真实的人通常得分较低。

返回示例

{
	"code": 0,
	"data": {
		"g_recaptcha_response": "03AGdBq25IfOUXaYfuQuZnxs5IQ0wsgQQ755yGyIajWHPPiKnlFuC5ml-JU1LS71KO8jKlLUG5Wo7Y4TcOMyrZ-Nn73k9lTuz9bn3NKiXgEGYPGquGbsQQakRgjt9vSpEqxKmXgWL6HkROOcBzNcQPQ7jkbOnnTm986c8Lf1QbhBed_h2G0cooBL7HAaDsq9nWsuuwh8tzZdpP73rEDWWaAk6bOh9bmGICrhYqXtkXoUe55Q61-tg6knsmP81SahHFQQkYhopztmS5Q0poZvPrH38ixKDuVRh3ibQmYMB5dCiuMuel27EDzK76beruS96pCf2wG3pk5kSD3Tj9Lspz_V2STstXwwq4J67OWNSUOciW9w0FB07btmLCHObJKJM7XxhG-Sm_hJdaqIhi6bVdOyzj7FWbNM_4tbFvO0cPdeoKbS4lR54hAs48PUEKsgPpZJNOzX8rzkVQn3VOIteocL8y1p_vJaZf40POS7-Qe7ceIeKaZBCdUHFQECIj4PCMLoXcb4IrGSDmz5ClwJ7-jeVj726tsoebezt_oRpy7LNpebjEFUYOVCY"  //g_recaptcha_response
	}
}

reCAPTCHA示例

错误码

302311sitekey 无效
302312请求参数错误
302313繁忙
不扣费,稍后重试
302314识别失败
不扣费,错误原因(message)
302303余额不足

以上为接口错误码,公共错误码见帮助中心