API Reference
English

微信小程序

小程序管理后台添加插件

1、登录微信公众平台,点击左侧下方设置 菜单

2、进入设置页面,点击第三方设置标签页

3、在插件管理模块中,点击添加插件按钮

4、搜索wxfp,选择插件,然后完成添加(申请之后,管理员会在第二天收到使用申请,若较紧急,可联系开发人员快速通过审批)

注意:如已经集成设备指纹插件wxfp,需升级插件版本至1.7.6及以上版本,然后可直接跳过该步骤,进入下一步集成

集成

1、小程序app.json里声明插件:

{

  "plugins": {
    "tdfp-plugin": {
      "version": "1.8.5",
      "provider": "wxc3b909c3d24c5417"
    }
  },
  
}

注意:三方框架可对应添加 如uni-app,可在manifest.json文件的mp-weixin模块中添加上述声明

2、初始化:

在app.js中

const plugin = requirePlugin('tdfp-plugin')
App({
  ...
  globalData: { // 设置全局变量
    _fmOpt: {
      partnerCode: "", // 请填入您的partner code
    }
  },
  onLaunch(){
    let fmagent = new plugin.FMAgent(this.globalData._fmOpt)
    fmagent.init()
  },
...
})

3、获取加密sign:

const plugin = requirePlugin('tdfp-plugin')
const fmagent = new plugin.FMAgent(app.globalData._fmOpt)
const fingalsign = fmagent.sign({
  path:'', // 仅支持字符串类型
})
if(fingalsign.code == 0) {
  // 获取签名并使用
  let sign = fingalsign.sign // 最终的sign值
} else {
  // 获取错误信息和状态码
  let msg = fingalsign.msg
  let errcode = fingalsign.code
  // 继续业务逻辑,此处签名可以用空字符替代
}

参数说明:

假设针对 https://baidu.com/user/profile 做接口保护,示例值可参考:

参数名类型示例&&说明
path字符串'user/profile'

状态码:

codemsg补充说明
0success
2000failed, path is emptypath为空,请传入对应path
2202path is not a stringpath不是个字符串
3001not supported不支持的环境
3002initialization failed初始化失败
3003sign failed加签失败
其他请联系同盾技术支持