钉钉开发文档

授权开通应用

更新时间: 2019-1-17

通过下面内容中您可以了解到,由于通过开通事件来获取企业信息可降级为后续通过钉钉服务端API获取,以及suiteTicket只有在正式应用中才会真正启用校验,因此即便您在测试应用中不处理推送或回调,也能达到开通应用并获取到企业信息和用户身份的目标。因此建议您在快速体验时可以先选择测试应用。

企业授权开通应用事件

此事件用于通知应用“哪个组织开通了本应用”,应用此时必须快速异步地初始化企业信息。

image.png

当企业管理员开通您开发的应用时,钉钉会把开通的企业标识corpId给推送下来,此推送称之为开通事件。应用应该把corpId持久化到数据库。
如果是HTTP回调方式,开发者必须立即发送(1秒内)成功处理的http response给钉钉服务器,而不应该在本事件内做大量耗时操作,从而给管理员开通应用流程提供更好的产品体验。

应用主动获取企业信息

应用即便没有接收到“企业授权开通应用”回调事件,或者没有处理好回调事件,钉钉的开通流程也会走完,并且会在钉钉客户端的工作页内出现此应用图标。在此情况,应用依然可以通过API补偿获取企业信息。

image.png

当企业内某员工第一次点击此应用图标进入到应用首页后,应用的前端可以获取到当前企业的corpId,此时通过应用服务端查询数据库,以检查是否有此corpId对应的开通记录。如果应用没有开通记录,则可通过调用“获取企业授权的凭证”接口来检查企业开通情况,成功返回凭证则可存入数据库。当无法获取到accessToken时,证明此企业没有给应用授权。

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!