一、进入钉钉的开放平台
- 在PC端下载钉钉客户端:https://open-dev.dingtalk.com/#/index
- 用户扫码登陆。
二、获取配置信息
1. 进入到后台管理后,打开应用管理
2. 创建应用
3. 进入钉钉应用界面,点击右上角的创建应用
4. 网页应用的配置
应用首页地址: Base URL+“plugins/servlet/getDingCode?”+“corpId”
PC端首页地址:Base URL+“plugins/servlet/getDingCode?”+“corpId”
管理后台地址: Base URL+“plugins/servlet/getDingCode?”+“corpId”
- Base URL如何获取?
corpId如何获取?
5. 赋权限,范围选择全部员工
需要开通权限:
- 个人权限:所有权限均开通
- 通讯录管理:除最后一个(通讯录基本数据读权限),其他的均开通
- 考勤:只开通调用企业API基础权限
- 消息通知:只开通chat相关接口的基础读取权限
- 硬件:所有权限均开通
- 获取凭证:所有权限均开通
- 待办任务:只开通钉钉待办事项相关接口权限
- 场景群:所有权限均开通
- 项目管理:所有权限均开通
个人权限 | ||
1 | 个人手机号信息 | Contact.User.mobile |
2 | 个人支付宝绑定信息 | Contact.User.alipayAccount |
3 | 日历应用中日程写权限 | Calendar.Event.Write |
4 | 日历应用中日程读权限 | Calendar.Event.Read |
5 | 通讯录个人信息读权限 | Contact.User.Read |
6 | 日历应用中日程闲忙状态读权限 | Calendar.EventSchedule.Read |
7 | 日历应用中日历读权限 | Calendar.Calendar.Read |
8 | 日历应用访问控制读权限 | Calendar.Acl.Read |
9 | 日历应用访问控制写权限 | Calendar.Acl.Write |
10 | 调用SNS API时需要具备的基本权限 | snsapi_base |
11 | 日历应用中日历写权限 | Calendar.Calendar.Write |
12 | 钉钉会议Rooms系统自定义屏幕读权限 | Rooms.DeviceTemplate.Read |
13 | 钉钉会议Rooms系统自定义屏幕写权限 | Rooms.DeviceTemplate.Write |
14 | 查询AI技能执行日志 | AIPaaS.SkillLog.Read |
15 | 以用户的个人身份创建或更新个人待办数据 | Todo.PersonalTodo.Write |
16 | 组织大脑数据集成写入权限 | Hrbrain.Import.Write |
17 | 钉钉365会员信息查看权限 | Vip.Member.User.Read |
通讯录管理 | ||
1 | 企业员工手机号信息 | fieldMobile |
2 | 邮箱等个人信息 | fieldEmail |
3 | 通讯录部门信息读权限 | qyapi_get_department_list |
4 | 维护通讯录的接口访问权限 | qyapi_manage_addresslist |
5 | 成员信息读权限 | qyapi_get_member |
6 | 根据手机号获取成员基本信息权限 | qyapi_get_member_by_mobile |
7 | 通讯录部门成员读权限 | qyapi_get_department_member |
8 | 企业活跃度数据访问权限 | qyapi_liveness_base |
9 | 企业外部联系人读取权限 | qyapi_ext_read |
10 | 企业外部联系人维护权限 | qyapi_ext_write |
11 | 查询行业通讯录信息权限 | qyapi_industry_info_read |
12 | 通讯录数据可见性的管理权限 | Contact.ReachableRule.ReadWrite |
13 | 通讯录企业账号迁移数据读权限 | Contact.OrgAccountMigration.Read |
14 | 通讯录数据可见范围管理权限 | Contact.Visibility.ReadWrite |
15 | 通讯录企业账号安全数据读写权限 | Contact.OrgAccountSecurity.ReadWrite |
16 | 通讯录组织基础信息读权限 | Contact.Org.Read |
17 | 企业账号加入其他组织后数据可见性权限 | Contact.OrgAccount.VisiblityInOtherOrg |
考勤 | ||
1 | 调用企业API基础权限 | qyapi_base |
硬件 | ||
1 | 智能设备写入绑定信息权限 | qyapi_smart_device_bind_write |
2 | 智能设备管理的基本权限 | qyapi_smart_device_base |
获取凭证 | ||
1 | 获取钉钉开放接口用户访问凭证的基础权限 | open_app_api_base |
代办任务 | ||
1 | 待办应用中待办写权限 | Todo.Todo.Write |
2 | 待办应用中待办读权限 | Todo.Todo.Read |
场景群 | ||
1 | 钉钉群基础信息管理权限 | qyapi_chat_manage |
项目管理 | ||
1 | 调用钉钉项目管理相关接口的权限 | qyapi_project |
2 | 项目应用任务写权限 | Project.Task.Write.All |
3 | 项目应用任务读权限 | Project.Task.Read.All |
4 | 项目应用项目写权限 | Project.Project.Write.All |
5 | 项目应用项目读权限 | Project.Project.Read.All |
6. 配置服务器出口ip与重定向URL
- 服务器出口IP:58.33.156.106(固定值)
- 重定向URL:环境访问地址
7. 配置回调域名:环境访问地址
上述步骤完成之后,就可获取应用参数,用于钉钉移动端配置。
三、配置扫码登录
1. 切换到钉钉旧版本,进入应用开发界面
2. 左侧菜单中找到移动接入应用,并点击登录
3. 创建扫码登录应用授权
名称:随意填写
描述:随意填写
授权Logo地址:logo链接地址
回调域名:jira环境地址(ip:端口)
4. 获取appid和appSecret
或者直接返回钉钉应用,点击扫码登入功能
5. 移动端配置扫码登录钉钉移动端配置。























