钉钉H5微应用开发以及接口调试
企业内部应用免登
https://open.dingtalk.com/document/orgapp-server/enterprise-internal-application-logon-free
1. H5微应用免登录开发
开发微应用
需要获取到钉钉企业的ID ,打开https://open-dev.dingtalk.com/ 地址获取,页面右上角的CorpId
钉钉官方提供的微应用免登授权码在线请求:
- 引入钉钉官方提供的js sdk
<script src="https://g.alicdn.com/dingding/dingtalk-jsapi/2.13.42/dingtalk.open.js"></script>
- 获取临时登录code免登授权码
dd.runtime.permission.requestAuthCode({
corpId: "企业ID",
onSuccess: function(result) {
result.code; //免登授权码
}
- 根据获取到的code请求后端接口,进入免登录流程
调试微应用
网页版调试:
https://open.dingtalk.com/document/resourcedownload/h5-micro-application-debugging-tool
RC版调试
https://open.dingtalk.com/document/resourcedownload/h5-debug
推荐使用RC版调试的Android调试包,使用谷歌浏览器打开chrome://inspect 地址进行调试
开发过程中可以使用穿透工具,方便打断点调试,省去发布过程,提高效率。
穿透工具推荐钉钉官方提供的工具
https://open.dingtalk.com/document/resourcedownload/http-intranet-penetration
以及开源的FastTunnel(gitee有源码以及文档
https://gitee.com/Hgui/FastTunnel?_from=gitee_search,目前已有1.9k星)
2. 免登录接口调用
服务端SDK下载:https://open.dingtalk.com/document/resourcedownload/download-server-sdk
.net 的还需要引入nuget包AlibabaCloud.SDK.Dingtalk
官方在线请求api文档:https://open.dingtalk.com/document/resourcedownload/api-explorer
还需要保存H5微应用的appkey以及appsecret在H5微应用控制台可得到
- 获取accessToken免登凭证,需要h5微应用应用的appkey和appsecret
在线请求地址,含有代码示例
- 通过免登码获取到用户信息,需要前端提供的code和后端获取到的accesstoken
- 获取用户详情,需要根据用户信息获取到的userid以及accesstoken(判断用户身份只需要走到第二步就行)