统一授权套件前端sdk

​

预期效果

​

个人授权

​

组织授权

​

管理员授权

​

非管理员授权

​

版本要求

import { getENV, } from 'dingtalk-jsapi/lib/env';
import { compareVersion, } from 'dingtalk-jsapi/lib/sdk/sdkLib';

const { platform, version, appType, } = getENV();
/**
 * 判断当前app版本是否支持使用SDK
 * @return {boolean}
 */
function isAuthSDKSupport() {
  return compareVersion(version, '6.3.35');
}

​

一、安装授权套件SDK

1. 执行以下命令，下载安装SDK（dingtalk-design-libs需要版本在0.1.0及以上）。
   npm install dingtalk-design-libs --save
   
2. 下载完成后，直接在代码中导入即可。
   import { openAuth } from 'dingtalk-design-libs/biz/openAuth';
   

​

二、应用授权接入

1. 引入钉钉统一授权套件SDK。
   import { openAuth } from 'dingtalk-design-libs/biz/openAuth';
   
2. 在需要用户授权时直接调用 openAuth 即可，请求示例如下：
   openAuth({
     clientId:'dingwlanwxxx', // 应用ID(唯一标识)
     corpId:'', // 当前组织的corpId
     rpcScope:'Calendar.Event.Write,Calendar.Event.Read,Contact.User.Read', 
     fieldScope:'Contact.User.mobile',
     type:0 // 0 标识授权个人信息；1 标识授权组织信息
   }).then((res)=>{
   // 处理返回数据
   })
   

​

请求参数

​

三、响应信息

​

返回示例如下：

• 授权完成
  {
   status: 'ok',
   result: {
   authCode:'xxxxxxx' // 如果是组织授权（type=1），则不返回该值
   }
  }
  
• 拒绝授权
  {
      status: 'cancel',
      result: null
  }
  
• 向管理员发送了授权申请，等待授权（只在组织授权场景下出现）
  {
      status: 'toAdmin',
      result: null
  }
  
• 授权异常
  {
      status: 'failed',
      result: null
  }
  

​

返回参数

​

错误码

​

参数错误

​

权限点相关错误

​

应用相关错误

​

授权相关错误

​

授权有效期