目前后端开发肯定离不开第三方接口对接,钉钉就是其中之一。
开发前所需
推荐postman测试,这工具谁用谁知道。
1:需要管理员在钉钉后台给予开发者 开发者权限
2:开发者权限给予后,开发者需要进入:
https://open-dev.dingtalk.com/#/index
(钉钉登录)
3:开发者获得
CorpId
4
:开发者→应用开发→微应用→微应用管理→创建套件→创建
5
:创建完毕后,创建套件内的微应用,完毕,联系主管理员,看↓
6
:开发信息→开发账号及管理→新增授权(让主管理员给开发者新增)
7
:新增数据后,子管理员看钉钉APP,会收到
CorpSecret
8:有了,corpid,corpsecret这两个数据,就可以进行开发工作了。
9:此时我们还需要创建个微应用,进入UIRL:
https://oa.dingtalk.com/index.htm#/microApp/microAppList
点工作台→自己应用,建造一个微应用,完毕后点生成的微应用右上角的小倒三角→设置
找到AgentID,记住,以后的企业群发消息时必须要它
开发第一步
有了corpid,corpsecret
进行get请求(传参别忘了替换):
https://oapi.dingtalk.com/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只能是一个