一、創(chuàng)建應(yīng)用
登錄釘釘后臺(tái)管理系統(tǒng)，創(chuàng)建一個(gè)適合自己需求的項(xiàng)目呢堰，
因?yàn)槲冶敬巫龅氖瞧髽I(yè)內(nèi)部的工作通知接口，所以選擇企業(yè)內(nèi)部開(kāi)發(fā)H5應(yīng)用
image.png
這里需要填寫(xiě)自主開(kāi)發(fā)
第二部選擇開(kāi)發(fā)應(yīng)該凡泣，微應(yīng)用枉疼，服務(wù)器出口IP就是IP白名單用，隔開(kāi)就可以傳多個(gè)鞋拟，填寫(xiě)完成點(diǎn)擊創(chuàng)建即可骂维。
image.png
創(chuàng)建完成之后再點(diǎn)擊h5微應(yīng)用就可以看到剛才創(chuàng)建的項(xiàng)目了，點(diǎn)擊項(xiàng)目查看詳情贺纲，就可以看到你項(xiàng)目的AgentId航闺、AppKey、AppSecret了
image.png
二、實(shí)現(xiàn)消息推送
1潦刃、獲取access_token
【注意】正常情況下access_token有效期為7200秒侮措，有效期內(nèi)重復(fù)獲取返回相同結(jié)果，并自動(dòng)續(xù)期乖杠。
請(qǐng)求方式：GET（HTTPS）
請(qǐng)求地址：https://oapi.dingtalk.com/gettoken?appkey=key&appsecret=secret
| 參數(shù) | 參數(shù)類(lèi)型 | 必須 | 說(shuō)明 |
|---|---|---|---|
| appkey | String | 是 | 應(yīng)用的唯一標(biāo)識(shí)key |
| appsecret | String | 是 | 應(yīng)用的密鑰 |
請(qǐng)求示范
DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest request = new OapiGettokenRequest();
request.setAppkey("appkey"); //替換剛才項(xiàng)目的appkey
request.setAppsecret("appsecret");
request.setHttpMethod("GET");
OapiGettokenResponse response = client.execute(request);
2分扎、發(fā)送工作通知
請(qǐng)求方式：POST（HTTPS）
請(qǐng)求地址：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN
參數(shù)說(shuō)明：
| 名稱(chēng) | 類(lèi)型 | 是否必須 | 示例值 | 描述 |
|---|---|---|---|---|
| agent_id | Number | 必須 | 1234 | 應(yīng)用 |
| agentId | String | 可選(userid_list,dept_id_list, to_all_user必須有一個(gè)不能為空) | zhangsan,lisi | 接收者的用戶(hù)userid列表，最大列表長(zhǎng)度：100 |
| dept_id_list | String | 可選（可不傳胧洒，若傳不能為空） | 123,456 | 接收者的部門(mén)id列表畏吓，最大列表長(zhǎng)度：20, 接收者是部門(mén)id下(包括子部門(mén)下)的所有用戶(hù) |
| to_all_user | Boolean | 可選 | false | 是否發(fā)送給企業(yè)全部用戶(hù) |
| msg | json對(duì)象 | 必須 | {"msgtype":"text","text":{"content":"消息內(nèi)容"}} | 消息內(nèi)容，消息類(lèi)型和樣例參考“消息類(lèi)型與數(shù)據(jù)格式”略荡。最長(zhǎng)不超過(guò)2048個(gè)字節(jié) |
