企业对接钉钉流程(企业内部应用-H5微应用)
官方文档写的很全了,非常值得细读。
本片,我们企业要接入钉钉(企业内部应用-H5微应用),取钉钉后台数据用。
开发前准备:
开发者需要管理员权限(建议自定义组织,待一切测试完毕,无误再向上级申请权限)
企业自主研发H5微应用
- 创建微应用
- 登录钉钉开发者后台,选择"应用开发"->“企业内部开发”->“H5微应用”,点击"创建应用",开始创建企业自建微应用。
- 填写应用基本信息。包括应用名称、应用Logo和应用简介,选择"企业内部自主开发",点击"下一步"。
- 开发模式选择“开发应用”,开发应用类型选择“微应用”,应用首页链接填写H5微应用首页url,服务器出口IP填写本企业服务器的公网IP。
- PC端首页地址填写说明,若填写此项,在钉钉PC端工作台展示该应用;若未填写则不展示。填写后PC端示例:
- 填写完成后,点击“创建”,即可成功创建微应用。
在”应用信息“那一行,点击“查看详情”,可以查看生成的appKey和appSecret,用于获取access_token进行开发。
- 新创建的应用,仅在创建者的钉钉工作台展示,不会在企业内其他成员工作台展示,即应用的可使用范围只有当前应用创建者。(可以在图上“应用发布”那里设置可见范围,以及是否发布应用,后面讲)
- 开发微应用
-
设置可使用人员
企业一般会有多个员工同时参与同一个微应用项目的开发,因此在开发微应用之前,需要设置参与的人员。
在创建微应用后,默认会将当前创建者添加到可使用范围内。若应用有多个开发者,管理员可以通过手机号码添加该应用的开发者。添加可使用范围后,工作台上展示该应用,可用于开发过程中体验与测试。 -
设置接口权限
钉钉开放了丰富的服务端接口能力,开发者可以借助这些接口能力,实现企业系统与钉钉的集成打通。在调用接口前,需要先申请并设置接口调用权限,比如消息通知、钉盘等基础权限。
为了保证企业的数据安全与应用稳定,请根据开发的微应用的产品功能,进行合理的配置权限。尤其针对高级权限,比如企业通讯录权限,需要选择授权范围,设置可获取哪些人员的通讯录信息。如下图所示。详情请参考接口权限申请流程。 -
免登流程
免登是指用户进入应用后,无需输入钉钉用户名和密码,应用程序可自动获取当前用户身份,进而登录系统的流程。
参考此文档了解免登流程。 -
JSAPI鉴权
JSAPI鉴权:钉钉提供了一些有Native能力的JSAPI,这些JSAPI有很多是手机的基础能力,对这些JSAPI的调用不需要进行鉴权(即不需要进行dd.config),只需要保证在dd.ready里面调用即可。对于一些钉钉业务相关、安全相关的JSAPI调用,需要开发者先进行鉴权然后再调用。
参考此文档了解JSAPI鉴权。
- 发布微应用
新创建的应用,应用共两种状态,分别是:
- 未发布状态:若人员在可使用范围内,可使用应用进行开发过程中体验与测试,且最多可添加20个可使用人员。
- 发布状态:可使用人员人数无限制,可根据需要设置。
当应用经过测试后,开发者可在应用发布页面发布应用,点击确认发布。如下图所示:
点击确定,如下图所示:
应用发布成功后,可修改应用可使用范围。可见范围可以设置全部员工、部分员工或者仅限管理员,如下图所示:
接下来就可以取做开发工作了。。。。
大大大大da橙子 发布了121 篇原创文章 · 获赞 92 · 访问量 19万+ 关注