钉钉H5微应用开发免登以及接口调试

钉钉H5微应用开发以及接口调试

企业内部应用免登

https://open.dingtalk.com/document/orgapp-server/enterprise-internal-application-logon-free

1. H5微应用免登录开发

开发微应用

  

  需要获取到钉钉企业的ID ，打开https://open-dev.dingtalk.com/ 地址获取，页面右上角的CorpId

  

  钉钉官方提供的微应用免登授权码在线请求：

https://open-dev.dingtalk.com/apiExplorer?spm=ding_open_doc.document.0.0.45642b498W49hm#/jsapi?api=runtime.permission.requestAuthCode

 

1. 引入钉钉官方提供的js sdk

<script src="https://g.alicdn.com/dingding/dingtalk-jsapi/2.13.42/dingtalk.open.js"></script>

 

2. 获取临时登录code免登授权码

dd.runtime.permission.requestAuthCode({

  corpId: "企业ID",

  onSuccess: function(result) {

 result.code; //免登授权码

}

 

3. 根据获取到的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微应用控制台可得到

1. 获取accessToken免登凭证，需要h5微应用应用的appkey和appsecret

在线请求地址，含有代码示例

https://open-dev.dingtalk.com/apiExplorer?spm=ding_open_doc.document.0.0.45642b498W49hm#/?devType=org&api=dingtalk.oapi.sso.gettoken

 

2. 通过免登码获取到用户信息，需要前端提供的code和后端获取到的accesstoken

https://open-dev.dingtalk.com/apiExplorer?spm=ding_open_doc.document.0.0.45642b498W49hm#/?devType=org&api=dingtalk.oapi.v2.user.getuserinfo

 

3. 获取用户详情，需要根据用户信息获取到的userid以及accesstoken(判断用户身份只需要走到第二步就行）

https://open-dev.dingtalk.com/apiExplorer?spm=ding_open_doc.document.0.0.51cb3a086Isuuh#/?devType=org&api=dingtalk.oapi.v2.user.get