后端项目与钉钉接口(第三方)对接要注意的问题

时间:2024-10-29 16:00:29

目前后端开发肯定离不开第三方接口对接,钉钉就是其中之一。

开发前所需

推荐postman测试,这工具谁用谁知道。

1:需要管理员在钉钉后台给予开发者 开发者权限

2:开发者权限给予后,开发者需要进入:/#/index(钉钉登录)

3:开发者获得  CorpId

4:开发者→应用开发→微应用→微应用管理→创建套件→创建

5:创建完毕后,创建套件内的微应用,完毕,联系主管理员,看↓

6:开发信息→开发账号及管理→新增授权(让主管理员给开发者新增)

7:新增数据后,子管理员看钉钉APP,会收到CorpSecret

8:有了,corpid,corpsecret这两个数据,就可以进行开发工作了。

9:此时我们还需要创建个微应用,进入UIRL:

/#/microApp/microAppList

点工作台→自己应用,建造一个微应用,完毕后点生成的微应用右上角的小倒三角→设置

找到AgentID,记住,以后的企业群发消息时必须要它

开发第一步

有了corpid,corpsecret

进行get请求(传参别忘了替换):

/gettoken?corpid=id&corpsecret=secrect

成功后得到JSON:

JSON会包含access_token,此数据2小时一失效,没它不能调用钉钉的接口了。

目前已知问题解决的方式

1:每次调用钉钉接口时,必须要传入access_token用来验证(除了获取本身)

2:要先查询所有部门的id,通过单个部门id才可以查询到部门旗下的userid及name。

3:  通过userid,部门id,微程序id(工作台自建应用获得),才可以进行企业消息发送

前端对接注意

1在调用接口时,确保access_token是参数并且不是过期数据或假数据

(access_token目前需要corpid,corpsecret这两个值去换,有两个小时时效)

2企业消息发送除了需要部门id或userid外,还需要微服务id(上工作台去创建应用获得)

3企业消息发送如果有部门id,就会发送到整个部门,不会跟着userid走,部门id,userid只能是一个