一、创建三方应用
在钉钉管理后台–>应用开发–>第三方企业应用–>创建应用(这边创建的是H5微应用)
创建成功之后,会得到应用凭证:appid,suiteid,suitekey,suitesecert
二、配置开发管理项
进入创建好的应用–>开发管理,配置应用首页地址,
选择推送类型及推送数据源,这边选择使用钉钉云推送,由于是本地测试,先提供一个可以外网访问的数据库地址来接收推送的数据(建库建表要根据开放平台的要求完全一致,否则会导致数据推送失败或数据乱码,参考地址)
在回调事件,可以选择需要钉钉推送给我们的消息类型,选择后,信息发生变化,数据库会收到钉钉云推送的消息。消息结构参考,后续授权过程使用到的suite_ticket、鉴权和消息推送使用到的agentid等都是从这些数据中解析得来的。
三、创建测试企业并授权
在当前应用的版本管理与发布模块,创建体验组织并授权来模拟第三方企业
四、授权流程
完成上面的基本配置就可以开始写代码了。授权流程基本和企业内部应用授权逻辑一致。
(1)前端获取corpid和code
a.获取corpid参考api
b.获取code(用上一步获取的corpid去换的)参考api
(2) 获取access_token
需要的参数:
accessKey,应用凭证的suitekey
suite_ticket,钉钉云推送的数据
corpid,前端传过来的当前企业corpid