简单使用,2步完成接入
不依赖其他组件,只需引入captcha.min.js即可。支持IE11、Chrome、Firefox、Safari、Opera、微信内置浏览器、移动端手机浏览器、iOS 及
Android上的内嵌Webview。
验证码会根据使用者情况动态调整滑动难度和作弊判断规则,同时也会尽量减少对正常用户验证体验上的影响。
1、前端引入JS
例一:
//准备个高190px的div
<div style="height:190px;" id="box1"></div>
//执行js初始化
var box1=document.getElementById("box1");
var obj1=captcha68Api.init(box1,function(token){
console.log("->",token) //token用于后端校验
},{
appId:null, //登录获取应用ID,用于自定义图片等,必填
cutShow:true, //是否显示图片,默认true
urlStart:null, //自定义验证码地址,可不填
urlVerify:null //自定义验证地址,可不填
});
//如果后端校验失败,前端可清理token且调用此方法刷新重来
obj1.refresh();
效果:
例二:
//准备个高40px的div
<div style="height:40px;" id="box2"></div>
//执行js初始化
var box1=document.getElementById("box2");
var obj1=captcha68Api.init(box1,function(token){
console.log("->",token) //token用于后端校验
},{
appId:null, //登录获取应用ID,用于自定义图片等,必填
cutShow:false, //是否显示图片,默认true
});
//obj1.refresh();刷新
效果:
2、后端校验结果
- 请求参数
- 返回参数
参数名 | 类型 | 必传 | 说明 | ||
---|---|---|---|---|---|
token | string | 是 | POST请求,验证成功后得到的token | ||
appKey | string | 是 | 滑动验证码密钥,和前端应用ID(appId)对应,登录后创建应用获取。 | ||
retry | int | 否 | POST请求,是否可以重试,默认0。 0不重试,同token下成功校验一次后token就会被删除,第二次请求无效。 1可以重试,网络环境较差情况下可以开启此选项,一共可以请求两次,第一次请求失败可以重新请求一次。 |
||
*注:滑动成功消耗5积分,校验接口请在后端请求,应用密钥不要前端传,后端请求接口时携带。 |
字段名 | 类型 | 必返 | 说明 |
---|---|---|---|
code | int | 是 | code=1校验成功,code=0校验失败 |
msg | string | 是 | 校验失败返回原因 |
check_time | int | 否 | code=1时返回接口首次成功校验时间戳 |
- 成功示例
- 失败示例
{"code":1,"check_time":1723668704,"msg":"验证通过"}
{"code":0,"msg":"验证超时,请在10分钟内操作"}