接入说明

接入“智能风控”js SDK开发者需要完成以下步骤：

1. 引入/安装js SDK文件
2. 初始化SDK
3. 在需要检测的位置，调用getToken接口
4. 测试验证SDK接入成果

接入步骤

引入/安装js SDK

通过“script”引入js, 请注意需要放在初始化代码之前。

示例代码：

<script src="./YiDunProtector-Web-1.0.0.js"></script>

初始化SDK

调用init接口执行SDK初始化。

示例代码：

const neg = createNEGuardian({ appId: '<APP_ID>', timeout: 10000 })

其中： appId 是应用标识，对应易盾控制台中的产品编号； timeout 数据上报超时时间，单位 ms，默认 6000。

调用getToken

在需要检测的位置调用接口getToken，上报信息并获取查询凭证。

示例代码：

neg.getToken().then(result => {
  if (result.code === 200) { // 正常情况
    alert('get token:', result.token)
  }
  if (result.code === 201) { // 离线模式
    alert('get token:', result.token)
  }
})

getToken 返回有两种模式：

• 正常模式，数据正常上报到设备指纹服务端，token长度固定；
• 离线模式，数据上报过程中出现异常，比如网络抖动/超时等，token长度不固定，请注意做兼容处理。

验证SDK接入成果

前端获取到 token 后，将 token 上传到业务服务器； 业务服务器根据 token 向智能风控服务器发起校验，查询结果； 更多token使用细节见智能风控服务端在线检测接口（check）。