1. 完成服务端部署
需要后端部署完成。接口返回以下必传参数
2. 引入初始化js函数
<script src="gt.js"></script>
3. 调用初始化函数进行初始化
initGeetest({
// data中以下配置参数来自服务端 SDK
gt: data.gt,
challenge: data.challenge,
offline: !data.success,
new_captcha: true
}, function (captchaObj) {
// 这里可以调用验证实例 captchaObj 的实例方法
})
注: 对于同一个页面存在多个验证码场景的初始化,需要每个验证码场景调用 initGeetest 方法单独进行初始化;如果一个场景下有多个验证入口,需要进行多次初始化。
4. API 参考
appendTo(position)
传入id选择器
<div id="captcha-box"></div>
...
<script>
initGeetest({
// 省略配置参数
}, function (captchaObj) {
captchaObj.appendTo('#captcha-box');
// 省略其他方法的调用
});
</script>
verify()
当product为bind类型时,可以调用该接口进行验证。
这种形式的好处是,允许开发者先对用户所填写的数据进行检查,没有问题之后在调用验证接口。
<div id="btn">提交按钮</div>
<script>
initGeetest({
// 省略配置参数
product: 'bind'
}, function (captchaObj) {
// 省略其他方法的调用
document.getElementById('btn').addEventListener('click', function () {
if (check()) { // 检查是否可以进行提交
captchaObj.verify();
}
});
captchaObj.onSuccess(function () {
// 用户验证成功后,进行实际的提交行为
// todo
})
});
</script>