以第三方企业微应用为例
在第三方企业微应用应用时,比较底层的需求,就是应用需要获取客户企业的通讯录,即部门/员工的数据。本人整理以下几个关键数据,供大家开发参考。
新建第三方微应用时,能拿到这些初始数据
[1-1] isv.encodingAesKey。手动配置。微应用设置界面拿到,用于解密、初始化应用、验证URL回调。
[1-2] isv.suiteKey。手动配置。微应用设置界面拿到,用于解密、初始化应用、验证URL回调。
[1-3] isv.token。手动配置。应用设置界面拿到,用于解密、初始化应用、验证URL回调。
[1-4] isv.suiteSecret。手动配置。设置页面拿到。
进行通讯,完成回调,能获取suiteTicket。
[2-1] isv.suiteTicket。钉钉推送。初始化后台,微应用设置界面推送,初始化。后续由微应用后台推送更新。
完成服务端与钉钉通讯,进行请求,能获取suiteAccessToken
[3-1] isv.suiteAccessToken。请求钉钉。由1-2,1-4,2-1为参数,请求钉钉得到。
进行企业授权,完成下面5个步骤,最终得到accessToken
[4-1] tmpAuthCode。钉钉推送。企业授权的时候,推送到回调地址。
[4-2] permenantCode,corpId,corpName。请求钉钉。由4-1,3-1为参数,请求钉钉得到。
[4-3] 激活企业。需要1-2,4-2(corpId,permenantCode),3-1。
[4-4] agentId。请求钉钉。需要1-2,1-4,2-1,4-2(corpId)
[4-5] accessToken。请求钉钉。需要1-2,1-4,2-1,4-2(corpId)
拿到企业accessToken,就能获取企业通讯录数据
[5-1] 获取企业部门、员工。需要4-5(accessToken)。
在实际的开发过程中,还是需要写不少代码的,如果读者有代码需求也可以加微信联系。