一、创建应用
登录钉钉后台管理系统,创建一个适合自己需求的项目,
因为我本次做的是企业内部的工作通知接口,所以选择企业内部开发H5应用
这里需要填写自主开发
第二部选择开发应该,微应用,服务器出口IP就是IP白名单用,隔开就可以传多个,填写完成点击创建即可。
创建完成之后再点击h5微应用就可以看到刚才创建的项目了,点击项目查看详情,就可以看到你项目的AgentId、AppKey、AppSecret了
二、实现消息推送
1、获取access_token
【注意】正常情况下access_token有效期为7200秒,有效期内重复获取返回相同结果,并自动续期。
请求方式:GET(HTTPS)
请求地址:https://oapi.dingtalk.com/gettoken?appkey=key&appsecret=secret
参数 | 参数类型 | 必须 | 说明 |
---|---|---|---|
appkey | String | 是 | 应用的唯一标识key |
appsecret | String | 是 | 应用的密钥 |
请求示范
DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest request = new OapiGettokenRequest();
request.setAppkey("appkey"); //替换刚才项目的appkey
request.setAppsecret("appsecret");
request.setHttpMethod("GET");
OapiGettokenResponse response = client.execute(request);
2、发送工作通知
请求方式:POST(HTTPS)
请求地址:https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN
参数说明:
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
agent_id | Number | 必须 | 1234 | 应用 |
agentId | String | 可选(userid_list,dept_id_list, to_all_user必须有一个不能为空) | zhangsan,lisi | 接收者的用户userid列表,最大列表长度:100 |
dept_id_list | String | 可选(可不传,若传不能为空) | 123,456 | 接收者的部门id列表,最大列表长度:20, 接收者是部门id下(包括子部门下)的所有用户 |
to_all_user | Boolean | 可选 | false | 是否发送给企业全部用户 |
msg | json对象 | 必须 | {"msgtype":"text","text":{"content":"消息内容"}} | 消息内容,消息类型和样例参考“消息类型与数据格式”。最长不超过2048个字节 |