欢迎访问 生活随笔!

生活随笔

当前位置: 首页 > 编程语言 > java >内容正文

java

Java中对接钉钉API获取数据流程

发布时间:2025/3/19 java 61 豆豆
生活随笔 收集整理的这篇文章主要介绍了 Java中对接钉钉API获取数据流程 小编觉得挺不错的,现在分享给大家,帮大家做个参考.

场景

需要做后台管理系统,接入钉钉API获取人员、考勤、审批等相关数据。

实现

钉钉开放平台应用开发文档

https://developers.dingtalk.com/document/app

首先需要联系钉钉的管理员,登录钉钉的后台,然后按照开发平台的文档指示

首先创建应用

 

然后填写应用的基本信息

 

让管理员创建应用的目的就是为了获取下面这两个AppKey和AppSecret

 

使用管理员登录钉钉管理平台并创建应用后,就是为了获取上面的AppKey和AppSecret,然后拿着这两个调用钉钉的接口,钉钉会返回token

调用其他的接口需要使用这个token。

注:

博客主页:
https://blog.csdn.net/badao_liumang_qizhi
关注公众号
霸道的程序猿
获取编程相关电子书、教程推送与免费下载。

然后在权限管理里面需要设置此应用有哪些权限

 

默认只有登录权限和消息通知的权限,然后可以在添加接口权限中添加需要用到的权限

 

选择完成之后点击确认。

Java开发流程

钉钉官方提供了统一的SDK,使用SDK可以便捷地调用服务端API。

 

下载之后将服务端sdk引入到项目中

 

在钉钉开放平台-开发工具-服务端API调试工具-API Explorer中可以直接将上面的两个AppKey和AppSecret复制过来然后选择语言进行调用

 

比如在Java中调用获取token的接口示例代码为

    public String getToken() throws ApiException {DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");OapiGettokenRequest req = new OapiGettokenRequest();req.setAppkey("钉钉后台应用的AppKey");req.setAppsecret("钉钉后台应用的Appsecret");req.setHttpMethod("GET");OapiGettokenResponse rsp = client.execute(req);System.out.println(rsp.getBody());return rsp.getAccessToken();}

然后获取token之后就可以使用这个token去访问钉钉的其他接口

比如通讯录管理下的部门管理中获取部门列表的接口,在中间按照要求填入参数,则在右边就会生成相关代码

 

示例代码

public class Main {public static void main(String[] args) {try {DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/department/list");OapiDepartmentListRequest req = new OapiDepartmentListRequest();req.setLang("zn_CN");req.setFetchChild(false);req.setId("1");req.setHttpMethod("GET");OapiDepartmentListResponse rsp = client.execute(req, "dsfsfdsfgs你获取的token");System.out.println(rsp.getBody());} catch (ApiException e) {e.printStackTrace();}} }

其他钉钉的API接口的访问流程类似。

其他

1.因为钉钉对接口访问的API的频率等有限制,建议在定时任务里调用钉钉相关接口,将数据获取并存储到自己的数据库中进行查询。

2.因为补卡机制,所以如果要获取考勤数据的话,比如允许补卡3天内的考勤数据,那么每天获取前四天的数据并进行覆盖

3.如果在调用接口时出现如下提示:

请求的部门id不在授权范围内

 

联系钉钉管理员登录后台,找到应用下的权限管理

 

把这里的权限范围改为全部员工

4.另外,钉钉要求访问其接口的ip地址必须提前配置,在开发管理里面的服务器出口ip

 

钉钉只允许在这里配置ip的服务器去调用其接口

如果在开发接口使用自己的电脑调用时,需要获取公网的服务器ip,浏览器百度Ip获取代理商的ip

 

不过这个ip会频繁改变,一旦请求接口出现ip不在白名单的情况,就要去重新查询,然后重新配置出口Ip。

所以建议将定时任务写好,直接将取数据的环节部署在公网服务器上,并配置服务器出口ip,这个ip可以设置多个,用逗号隔开。

总结

以上是生活随笔为你收集整理的Java中对接钉钉API获取数据流程的全部内容,希望文章能够帮你解决所遇到的问题。

如果觉得生活随笔网站内容还不错,欢迎将生活随笔推荐给好友。