钉钉h5微应用鉴权配置客户端 API 鉴权步骤

KLW752024-12-29 20:37

这里记录一下使用的钉钉h5微应用配置客户端 API 鉴权的内容

注意不是所有的都功能都需要鉴权。

先要引入钉钉环境见下链接

https://blog.csdn.net/KLS_CSDN/article/details/144794982?spm=1001.2014.3001.5501

引入鉴权代码到前端页面并配置以下参数：

javascript 复制代码

dd.config({
    appId: '', // 必填，授权企业的agentid
    corpId: '',//必填，企业ID
    timeStamp: '', // 必填，生成签名的时间戳
    nonceStr: '', // 必填，自定义固定字符串。
    signature: '', // 必填，签名
    type:0/1,   //选填。0表示微应用的jsapi,1表示服务窗的jsapi；不填默认为0。该参数从dingtalk.js的0.8.3版本开始支持
    jsApiList : [
        'biz.contact.choose',
    ] // 必填，需要使用的jsapi列表，注意：不要带dd。
});

dd.error(function (err) {
    alert('dd error: ' + JSON.stringify(err));
})//该方法必须带上，用来捕获鉴权出现的异常信息，否则不方便排查出现的问题

注意其多个参数都是需要后端计算后返回给前端使用的微应用type要使用0.

企业的corpid就可以去钉钉管理后台右上角头像那里找也可以都让后端给返回。

配置完成后使用dd.ready

javascript 复制代码

dd.ready(function() {
  dd.biz.contact.choose({
    multiple: true, //是否多选：true多选 false单选； 默认true
    users: ['10001', '10002', ...], //默认选中的用户列表，员工userid；成功回调中应包含该信息
    corpId: 'dingb4ff1079f****54', //企业id
    max: 10, //人数限制，当multiple为true才生效，可选范围1-1500
    onSuccess: function(data) {
    /* data结构
      [{
        "name": "张三", //姓名
        "avatar": "
http://g.alicdn.com/avatar/zhangsan.png
" //头像图片url，可能为空
        "emplId": '0573', //员工userid
       },
       ...
      ]
    */
    },
    onFail : function(err) {}
 });
}

这里的biz.contact.choose 只是举一个例子你需要什么功能可以去链接中找。

H5微应用JSAPI总览 - 钉钉开放平台

钉钉开发h5微应用文档链接总结-CSDN博客