钉钉(自建应用)如何授权
钉钉,阿里巴巴出品,专为全球企业组织打造的智能移动办公平台,含PC版,Ipad和手机版。远程视频会议,消息已读未读,DING消息任务管理,让沟通更高效;移动办公考勤,签到,审批,企业邮箱,免费企业OA,企业通讯录,钉钉教育解决方案,让工作学习更简单。 官网: https://www.dingtalk.com
- 关于钉钉接口使用说明:
1.钉钉标准版、钉钉专业版、钉钉专属版的Webhook&Stream消息通道将于2023年12月1日正式开始商业化,对调用量做次数限制,钉钉标准版享有免费5000次/自然月的Webhook&Stream调用量。
2.标准版钉钉组织,企业内部应用、委托第三方定制开发企业内部应用,每个应用调用服务端接口每秒并发的最高频次限制为20qps;除不纳入每月调用量限制的接口(包括获取访问凭证接口、身份验证(免登)接口、通讯录接口、宜搭接口和生态接口,详细接口请查看附录A :不纳入每月调用量限制的接口清单)之外,其他接口累计可调用次数调整为10000次/月。
详情请查看钉钉官方文档:https://open-dev.dingtalk.com/fe/noticeDetail?id=254234
关于订阅设置
如果希望锁定钉钉推送数据范围(即:精细化管理钉钉的接口流量使用),可以点击上一张图中的【订阅设置】进行相应配置,可以锁定接口推送的钉钉审批模板。
订阅地址填写方式:
方式1:
/v1.0/event/bpms_instance_change/**/PROC-57EE931C-07A7-4F2A-A846-052BA54332D2/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,这样就只推送指定的模板数据了。
方式2:
/v1.0/event/bpms_instance_change/** /{PROC-57EE931C-07A7-4F2A-A846-052BA54332D2,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7}/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,{}里多个模板code之间用英文逗号分隔,可以填三个,推送指定的模板数据。
![image](https://editdoc.tizdata.com/images/9/593/1719236853000-image.png)
钉钉自建应用
1.登录钉钉开发平台
1.1.打开钉钉开放平台。
地址:https://open.dingtalk.com/
1.2.登录后,点击右上角的【我的后台】。
![image](https://editdoc.tizdata.com/images/9/593/1718947163000-image.png)
1.3.在管理后台的【首页】,点击下图位置的Corpid。把信息保存下来(后面会用到)。
![image](https://editdoc.tizdata.com/images/9/593/1718948540000-image.png)
2.创建钉钉的自建应用
2.1.点击【应用开发】,进入企业内部自建应用。
![image](https://editdoc.tizdata.com/images/9/593/1718947265000-image.png)
2.2.找到界面上的【创建应用】,点击后进行应用创建。
![image](https://editdoc.tizdata.com/images/9/593/1718947445000-image.png)
2.3.填写相应信息后,点击【保存】。
![image](https://editdoc.tizdata.com/images/9/593/1718947561000-image.png)
2.4.之后进入到应用的配置界面。需要 进行2个配置操作。
配置1:找到【凭证与基础信息】配置,进行相应操作。
点击下图位置的AgentId、AppKey、AppSecret。把信息保存下来(后面会用到)。
![image](https://editdoc.tizdata.com/images/9/593/1718950680000-image.png)
配置2:找到【权限管理】配置,进行相应设置。
如下图中的红框部分,依次对【个人权限】、【通讯录管理】、【OA审批】进行授权。
操作方法:依次勾选全部授权接口列表后,点击【批量申请】。
![image](https://editdoc.tizdata.com/images/9/593/1718947828000-image.png)
配置3:找到【事件订阅】配置,进行相应设置。
推送方式,选择Http推送。如下图:
![image](https://editdoc.tizdata.com/images/9/593/1718948419000-image.png)
点击下图中的2个图标,可以看到aes_key、token,把信息保存下来(后面会用到)
![image](https://editdoc.tizdata.com/images/9/593/1718951169000-image.png)
3.安捷云中创建钉钉自建应用
3.1.登录安捷云,选择应用账户,点击新建应用账户,选择钉钉自建应用。
![image](https://editdoc.tizdata.com/images/4/148/1729821996000-image.png)
![image](https://editdoc.tizdata.com/images/4/148/1729834594000-image.png)
把上面保存的信息,填入到相应位置,之后点击【测试并保存】,则系统会返回出auth_hook_url。
![image](https://editdoc.tizdata.com/images/4/148/1729834530000-image.png)
3.2.把上一步获取的auth_hook_url回填到钉钉自建应用中。
![image](https://editdoc.tizdata.com/images/9/593/1718951543000-image.png)
3.3.上一步保存后,在钉钉的【事件订阅】中开启【审批事件】的订阅。自此,配置完毕。
![image](https://editdoc.tizdata.com/images/9/593/1719207897000-c7c786513122892a444f5c9714d3522.png)
4. 钉钉自建应用版本发布
完成上述操作后,点击【版本管理与发布】,创建一个新版本。
填入一下信息后将应用发布。需要注意的是每次授权的更改都需要发布一次版本,否则系统还是会取未发布版本。
![image](https://editdoc.tizdata.com/images/4/148/1733203993000-image.png)
[温馨提示]关于订阅设置
如果希望锁定钉钉推送数据范围(即:精细化管理钉钉的接口流量使用),可以点击上一张图中的【订阅设置】进行相应配置,可以锁定接口推送的钉钉审批模板。
订阅地址填写方式:
方式1:
/v1.0/event/bpms_instance_change/**/PROC-57EE931C-07A7-4F2A-A846-052BA54332D2/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,这样就只推送指定的模板数据了。
方式2:
/v1.0/event/bpms_instance_change/** /{PROC-57EE931C-07A7-4F2A-A846-052BA54332D2,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7}/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,{}里多个模板code之间用英文逗号分隔,可以填三个,推 送指定的模板数据。
![image](https://editdoc.tizdata.com/images/9/593/1719236853000-image.png)