首发于 前端知识分享
切换模式
浙政钉（专有钉钉）对接文档
玉藻前
平安京的变化，可真大呀！
介绍
专有钉钉是浙政钉的测试版本，可在正式发布之前进行业务开发。
一、 创建应用
- 打开专有钉钉开放平台，登录ISV账户。
- 进入 管理工作台 - 通讯录 - 组织与人员管理，新增自己的账户，然后使用该账户在专有钉钉移动端登录，（专有钉钉移动端需手动下载 下载地址），然后继续PC端的操作。
- 创建并配置应用
- 在开发者后台-我的应用-组织内部应用中点击创建，创建你的应用；
- 创建好之后，点击详情，可以查看应用的相关信息：
其中，可以查看生成的appKey和appSecret，获取access_token进行开发。
- 点击应用配置，点击编写，填写相关信息后，如移动端首页地址（你测试应用的移动端页面地址），点确定。
- 应用权限，进入权限管理页面。设置应用访问通讯录范围，开启应用所需要的服务端接口、H5微应用JSAPI接口权限以及数据权限。请仅仅选择需要的权限进行授权。
- 点击应用发布，即可将应用 上架 发布至专有钉钉客户端上。
如果在客户端中没有发现你的应用，可进入 管理工作台 - 用户工作台 - 找到你的工作台，点击 应用管理，将你的微应用移动至你的工作台中即可。
注意：发布后，如需新增授权操作，请先下架应用后，再进行相关授权，授权完成后再进行上架。
二、应用开发
注： 部分后端接口及前端api需要手动在应用开发中进行授权，分为服务端和客户端，请根据需要进行授权使用。
- 获取应用access_token
可在 应用开发 里看到本应用的appKey和appSecret，可由后台开发接口调用生成access_token，前端开发获取该access_token进行相关操作。
接口： /gettoken.json
| 参数 | 说明 |
|---|---|
| appKey | 必须，应用唯一标识 |
| appSecret | 必须，应用密钥 |
2. 获取免登授权码auth_code，进行免登操作
通过调用前端api来进行获取auth_code
dd.getAuthCode().then(res => {
console.log(res)
}).catch(err => {
console.log(err)
})
| 参数 | 说明 |
|---|---|
| code | 授权码（适用于移动端），有效期5分钟，且只能用一次 |
| auth_code | 授权码（适用于PC端），有效期5分钟，且只能用一次 |
| expireTime | 失效时间（秒） |
专有钉钉H5微应用使用code进行免登操作。
3. 获取用户信息
有两种方案，一种使用钉钉api获取：
dd.getLoginUser().then(res => {
console.log(res)
}).catch(err => {})
返回值
| 参数 | 说明 |
|---|---|
| name | 用户名 |
| mainOrg | 用户所属单位 |
| accountId | 账户id |
| avatarMediaId | 头像 |
另一种是后端接口返回：
接口：/rpc/oauth2/dingtalk_app_user.json
请求参数：
| 参数 | 说明 |
|---|---|
| access_token | 必须，string |
| auth_code | 必须，string |
使用该方式获取用户详情，可获取较全面的信息，以供使用。
4. jsApi鉴权
在使用需要鉴权的jsapi时，需要进行鉴权操作。
- 首先在 应用开发 - 应用权限 - 客户端 权限中对需要鉴权的jsapi进行授权
- 获取鉴权ticket，通过后台接口获取
/get_jsapi_token.json
| 参数 | 说明 |
|---|---|
| access_token | 应用token |
前端调用后端提供的接口后，获取到ticket，进行鉴权操作：
dd.authConfig({
ticket: "your ticket",
jsApiList:["需要鉴权的jsapi方法名"]
}).then(res =>{
console.log(res)
}).catch(err =>{})
鉴权之后，就可以使用你所需要的jsapi了。
编辑于 2022-03-28 15:12
钉钉
文章被以下专栏收录
