需求背景：
将一个A系统接入钉钉平台，供该企业内部员工使用等，实现移动化办公。
主要需求：
- 可以使用钉钉通过扫描二维码的方式登录A系统
- 可以在A系统中共享钉钉的组织架构
技术调研思路：
第一阶段：在钉钉官网查看开发者文档
接入场景主要有四种：
- 企业内部开发 https://open-doc.dingtalk.com/microapp/bgb96b
- 第三方企业应用 https://open-doc.dingtalk.com/microapp/isv
- 第三方个人应用 https://open-doc.dingtalk.com/microapp/personnal
- 移动应用接入 https://open-doc.dingtalk.com/microapp/native
第二阶段：选择可行方案
根据需求，我们的使用场景为：仅供某个企业内的成员使用，其他企业无法使用该应用，所以优先选择企业内部开发方案。
企业内部开发
基于钉钉的开放能力，自主开发，供企业或组织内部使用，以满足办公场景中的个性化需求。该类应用无需钉钉团队审核。
应用类型
可以开发E应用、微应用两种类型的应用。
E应用是一种全新的开发模式，让移动开发者通过简捷的前端语法写出Native级别的性能体验，并支持iOS、安卓、等多端部署。E应用暂不支持PC端部署，如果您的应用必须要在PC端上使用，可暂时使用微应用开发方式。
微应用是指用H5方式开发的应用。
E应用和微应用的对比：
| E应用 | H5微应用 | |
|---|---|---|
| 加载性能 | 首次使用略慢，后续加载快 | 受到很多因素影响，优化不够好，容易慢 |
| 使用体验 | 非常顺滑，接近 Native | 容易卡顿 |
| 开发环境搭建 | 提供 IDE，快速创建项目 | 成本高 |
| 调试 | 提供 IDE，可以在电脑上调试大部分功能 | 在电脑上只能调 UI，涉及到钉钉的 jsapi，必须真机调试 |
| 使用开源 UI 组件 | 目前不支持 | 支持 |
| 使用 npm 包 | 支持 | 支持 |
| 模块化组织代码 | 支持 E应用 特有的模块化 | 使用 vue, React 等框架可以轻松获得模块化支持 |
| 灰度发布 | 钉钉提供 | 需要自己实现 |
| CDN | E应用包默认在 CDN | 需要开发者自己购买相关服务 |
| 开发个人应用 | 支持 | 不支持 |
| 应用离线化 | 支持 | 不支持 |
由于E应用主要针对手机平台，ios 和 android，而且暂不支持在PC端使用。E应用比较坑人的地方是必须购买阿里云的服务器，而且基础版的价格是2万每年。（果断放弃！）
比较并验证可行性之后，最终选择实现方案：钉钉微应用接入（企业内部开发）
实现步骤
创建应用
- 企业管理员登录钉钉管理后台，选择导航【工作台】，点击【自建应用】，开始创建自建应用。
- 填写基础信息
填写应用基本信息。包括应用名称、logo和简介等。选择企业内部自主开发。 - 开发模式选择“开发应用”，应用类型选择“微应用”。
- 创建成功过后，会生成appKey和appSecret，可获取access_token进行开发
开发应用
钉钉开放平台提供丰富的API接口，以便开发者接入。
钉钉开放平台提供了企业通讯录管理、文件管理、发送企业会话消息等功能，接口使用可以参考服务端开发文档。https://open-doc.dingtalk.com/microapp/serverapi2/gh60vz
钉钉开放平台提供了微应用在钉钉客户端运行的专用容器，并提供一组可以调用钉钉的本地能力和业务能力的JSAPI接口，JSAPI接口用于微应用与钉钉功能之间的结合，接口使用可以参考客户端开发文档。https://open-doc.dingtalk.com/microapp/dev/welcome-to-lark
扫码登录第三方网站
使用钉钉客户端扫码并确认登录您的web系统，在您的系统内获得正在访问用户的钉钉身份，而用户无需输入账户密码。
注: 此功能与企业自建应用/第三方企业应用无关，只能用扫码登录打开第三方网站，并且不是钉钉内的应用免登，此流程只能做到获取到用户身份（无手机号和企业相关信息）。
获取appId及appSecret
点击进入钉钉开发者平台 的页面，点击左侧菜单的【移动接入应用】，然后点击右上角的【创建扫码登录应用授权】，创建用于免登过程中验证身份的appId及appSecret，创建后即可看到appId和appSecret。
构造扫码登录页面
- 第一种方式是直接使用钉钉提供的扫码登录页面
在企业Web系统里，用户点击使用钉钉扫描登录，第三方Web系统跳转到如下地址：
https://oapi.dingtalk.com/connect/qrconnect?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI
url里的参数需要换成第三方Web系统对应的参数。在钉钉用户扫码登录并确认后，会302到你指定的redirect_uri，并向url参数中追加临时授权码code及state两个参数。
- 第二种方式是支持网站将钉钉登录二维码内嵌到自己页面中
用户使用钉钉扫码登录后JS会将loginTmpCode返回给网站。JS钉钉登录主要用途：网站希望用户在网站内就能完成登录，无需跳转到钉钉域下登录后再返回，提升钉钉登录的流畅性与成功率。
https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6#a-namegpdvgqa%E7%AC%AC%E4%BA%8C%E7%A7%8D%E6%96%B9%E5%BC%8F%E6%98%AF%E6%94%AF%E6%8C%81%E7%BD%91%E7%AB%99%E5%B0%86%E9%92%89%E9%92%89%E7%99%BB%E5%BD%95%E4%BA%8C%E7%BB%B4%E7%A0%81%E5%86%85%E5%B5%8C%E5%88%B0%E8%87%AA%E5%B7%B1%E9%A1%B5%E9%9D%A2%E4%B8%AD
同步组织架构
调用钉钉提供的相关接口
用户管理：https://open-doc.dingtalk.com/microapp/serverapi2/ege851
部门管理：https://open-doc.dingtalk.com/microapp/serverapi2/dubakq
角色管理：https://open-doc.dingtalk.com/microapp/serverapi2/dnu5l1
相关文档
企业内部开发常见问题：https://open-doc.dingtalk.com/microapp/bgb96b/mdg058
开发企业内部应用：https://open-doc.dingtalk.com/microapp/bgb96b/gt5d6a
钉钉微应用接入（企业内部开发）：https://blog.csdn.net/Jason847/article/details/75007140/
扫码登录第三方网站：https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6
JavaWeb开发
初步实现网站应用钉钉扫码登录：https://blog.csdn.net/baofeidyz/article/details/59059379
第三方网站通过 钉钉 扫描二维码登录/免密码登录，获取手机号码、邮箱等信息：https://www.jianshu.com/p/6a61043c79c9
网友评论