> >

Web

概述及资源

环境需求

条目 内容
兼容性 IE8+、Chrome、Firefox、Safari、Opera、主流手机浏览器、iOS 及 Android上的内嵌Webview

安装

  1. 在页面head中引入js

    <script src="v2.sense.js?id=[您的app_id]&t=[时间戳防止缓存]"></script>

    v2.sense.js联系客服获取,暂时不提供线上下载地址。

  2. 调用函数
    引用js后,会返回SensePro全局对象,SensePro有三个方法, 具体如下:

    • SensePro.onReady(callback) Sense对象加载完毕,调用getSid等方法

    • SensePro.getSid(successCallback, errorCallback) 用于获取当前 session_id 用作verify接口字段

    • SensePro.destroy() 用于销毁Sense对象

    • SensePro.load(successCallback, errorCallback) 重新加载,用于js加载失败
      • successCallback { Function } 成功回调函数
      • errorCallback { Function } 错误回调函数,返回错误信息{Object}, 结构如下:
        • code { String } 错误码
        • msg { String } 错误描述

错误码说明

code msg
2001 sense对象未加载成功
2002 sense id 必填
1000 sense id 必填
1001 gt_judgement请求网络报错
1004 前端调用setInfos接口出错
1005 获取session_id出错

1001错误时,表示调用极验服务失败,请直接发送服务,避免阻塞。同时在服务后端调用极验gt_verify,验证是否真的是极验服务宕机,防止前端请求可能被篡改。如果确认极验服务离线,可执行自己配置的后续流程。如果极验服务正常返回请求,重新调起前端服务即可。

示例

加载js之后,可以在场景中使用,示例代码如下

$('#btn').click(function () {
// 通过回调获取session_id
SensePro.getSid(function(sid) {
sid && $.ajax({
url: '/gt/verify-dk-v2',
type: "post",
dataType: "json",
data: {
session_id: sid, // 查询结果的凭证
phone: '123', // 手机号
password: '123' // 密码
},
success: function (result) {
console.log(result);
}
})
}, function(err) {
console.log(err);
});
})