源碼已上傳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 : 存放測試類