1. 前端接入
在页面中引入 widget.js,添加容器元素:
<script src="http://your-server:9876/widget.js"></script>
<div id="captcha-box"></div>
<script>
GoCaptcha.render('captcha-box', {
siteKey: 'YOUR_SITE_KEY',
serverUrl: 'http://your-server:9876',
onSuccess: function(token) {
// token 用于后端验证
document.getElementById('captcha_token').value = token;
}
});
</script>
2. 后端验证
用户提交表单后,后端用 SecretKey 验证 Token
POST /api/siteverify
Content-Type: application/json
{
"secret": "YOUR_SECRET_KEY",
"token": "用户提交的captcha token"
}
// 响应
{"success": true, "challenge_ts": "...", "site_key": "..."}
3. API 端点
GET /api/captcha?site_key=xxx →生成验证码
POST /api/captcha/verify →用户端验证
POST /api/siteverify →后端 Token 验证
GET /widget.js →前端 Widget