源码已上传GitHub:传送门
一、准备事项
1.1 一个能在公网*问的项目:
1.2 一个钉钉账号
1.3 创建一个应用
登录钉钉后台—>工作台—>自建应用
二、钉钉的配置参数
2.1 CorpID 和 corpSecret
首先登录开发者平台: 登录钉钉后台—>工作台—>自建应用—>应用开发,即可进入开发者平台
然后,开发者账号管理—>生成corpSecret
2.2 AgentId
登录钉钉后台—>工作台—>自建应用—>设置,即可看到agentId
2.3 IP白名单
首先登录开发者平台—>开发者账号管理—>点击cropSecret的修改按钮
三、钉钉开发思路
其实不管是微信开发还是钉钉开发,又或者是其他开发API接口的开发,本质上都是对接口开发,表现为,我们封装好请求参数,通过http请求调用他们的接口,然后他们返回给我们想要数据,我们拿到数据后进行相应的业务处理。
抛弃业务处理这一层不看,钉钉、微信类似的开发的目的就成了 获取钉钉、微信数据,所以我们的关注点应该在于 获取数据,至于如何获取,那就是调接口。
如何调接口,流程大体如下:
1.准备好接口调用凭证(accessToken、jsapiTickt等)
2.准备好请求参数
参考官方文档,封装好该接口所需的参数。至于参数的数据类型(是long是String还是float等)、请求参数的数据交换格式(是json格式,还是xml格式等),一切请按官方文档来。
3.拼接好接口url
4.发送http请求来调用接口,并接收好返回的数据
四、源码简介
4.1 部署工程
4.1.1 从github clone源码到本地
4.1.2导入项目到eclipse中
4.1.3 将Env.java 中的配置参数修改成你自己的
4.2 工程目录结构
HttpHelper.java : http请求工具类,get、post
Evn.java : 存放钉钉配置参数
AuthHelper.java :获取钉钉相关参数的工具类,包括获取accessToken、jsapiTickt
com.ray.dingtalk.test : 存放测试类