Java后端获取钉钉企业打卡信息

原创 已于 2025-03-20 21:05:04 修改 · 1.2k 阅读 · 22 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#钉钉 #java

于 2025-03-20 20:54:10 首次发布

文章目录

前言

企业需要同步钉钉考勤打卡的数据进行加工处理，该如何去获取考勤信息。

一、钉钉企业注册

企业注册后默认为标准版服务，标准版服务可满足日常打卡，考勤数据Excel导出功能。不可设置上下级组织。

标准版与其他版不同的内容为:

1、即时通讯：电话&短信DING消息、聊天记录云端搜索

2、视频会议：单场会议时长、同时开启摄像头人数、电话入会等

3、办公协同：OA审批专业版、考勤专业版（

​ a、支持考勤报表专家模式，支持定制化设计考勤报表字段，满足企业各类统计需求；

​ b、支持统计自定义（团队统计、员工统计）；

​ c、支持【考勤封账】能力，帮助企业对考勤的数据进行冻结；

​ d、支持创建年度报表，跨多个月和年度考勤数据的汇总计算和导出，方便企业进行年度或是半年度的考勤汇总统计。）

4、直播：时长、清晰度、三方推流、智能章节、屏幕水印

5、业务应用打造：工作台模板、企业工作台自定义

6、组织文化打造：企业专享身份标识、高管保护模式

7、安全合规能力：企业数据审计、企业行为安全管控等

8、存储能力：存储空间

9、开放能力：付费API调用量、API请求并发量、连接流节点执行量、专享OpenAPI等
在这里插入图片描述

标准版应用开发与连接流资源

付费 API 调用量：5000 （次/自然月）

API 请求并发量：20（次/秒）

连接流节点执行量：500（次/自然月）

Webhook 和 Stream 用量：3000（次/自然月）
在这里插入图片描述

钉钉登录后我们可以看到对应的后台界面，可以设置对应功能信息。

在这里插入图片描述

我们点击开发者服务下的连接平台，可以进入到开发者平台

在这里插入图片描述

进入开发者平台后创建应用

在这里插入图片描述

二、接下来去查询服务端API找需要的接口

获取考勤信息接口参见：https://open.dingtalk.com/document/orgapp/api-overview

注：该接口调用需要使用到旧版的SDK，该获取打卡结果接口调用量说明中的**“钉钉标准版接口累计可调用次数为1万次/月”**有误，因为该接口文档更新于 2023-01-18日，但是在2024年12月标准版接口累计调用次数改为了5千次/月。

在这里插入图片描述

旧版SDK下载使用页面为：https://open.dingtalk.com/document/resourcedownload/download-server-sdk

在这里插入图片描述

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/user/get");
OapiUserGetRequest req = new OapiUserGetRequest();
req.setUserid("userid1");
req.setHttpMethod("GET");
OapiUserGetResponse rsp = client.execute(req, accessToken);

请求示例说明：

  1. 定义Client对象，设置接口地址URI。一般情况，无需拼接URL后面的参数，比如access_token；需要注意部分Post接口，需要在URI后拼接除access_token外的个别参数。
  2. 构造Request对象，接口对应的request对象，一般规则是Oapi+接口Path驼峰形式+Request，如/user/get接口，请求对象是OapiUserGetRequest。
  3. 调用Request的方法设置参数，注意参数HttpMethod，默认是POST，如果是GET类型接口，需要这样设置request.setHttpMethod(“GET”)。
  4. 调用client.execute执行，其中access_token同样可以使用SDK获取到。同时，/gettoken，/sns/gettoken，/service/get_suite_token等获取token的接口在调用execute时，无需再传token参数。
  5. 执行后得到Response对象，是与Request对应的，然后可获取执行结果。

SDK下载后添加maven依赖

环境依赖

  • Java SDK 需要依赖 Java SE/EE 1.5及以上
<dependency>
 <groupId>com.aliyun</groupId>
 <artifactId>alibaba-dingtalk-service-sdk</artifactId>
 <version>2.0.0</version>
</dependency>

获取打卡结果

请求方式：POST

请求地址：https://oapi.dingtalk.com/attendance/list

其它参数信息见：https://open.dingtalk.com/document/orgapp/api-overview

请求示例：

注：需要带access_token。例：POST https://oapi.dingtalk.com/attendance/list?access_token=ACCESS_TOKEN

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/attendance/list");
OapiAttendanceListRequest req = new OapiAttendanceListRequest();
req.setWorkDateFrom("2020-11-07 08:00:00");
req.setWorkDateTo("2020-11-11 08:00:00");
req.setUserIdList(Arrays.asList("manager"));
req.setOffset(0L);
req.setLimit(10L);
req.setIsI18n(true);
OapiAttendanceListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

获取打卡详情

请求方式：POST

请求地址：https://oapi.dingtalk.com/attendance/listRecord

其它参数信息见：https://open.dingtalk.com/document/orgapp/api-overview

请求示例：

注：需要带access_token。例：POST https://oapi.dingtalk.com/attendance/listRecord?access_token=ACCESS_TOKEN

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/attendance/listRecord");
OapiAttendanceListRecordRequest req = new OapiAttendanceListRecordRequest();
req.setUserIds(Arrays.asList("user123","user456"));
req.setCheckDateFrom("2020-11-07 08:00:00");
req.setCheckDateTo("2020-11-12 08:00:00");
req.setIsI18n(false);
OapiAttendanceListRecordResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

由于传参需要userId还需要获取人员信息，可以通过获取部门用户userid列表接口获取

在这里插入图片描述

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/user/listid

Query参数：access_token 调用该接口的应用凭证。

Body参数：dept_id部门deptId，可通过以下方式获取：

返回参数：

在这里插入图片描述

获取部门列表

在这里插入图片描述

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/v2/department/listsub

在这里插入图片描述

返回参数：

在这里插入图片描述

建议部门以及人员信息在初期人员确定后，直接保存在本地数据库中减少付费 API 调用量。

注：需要注意查询考勤打卡记录的起始工作日到考勤打卡记录的结束工作日，最多相隔7天。

每个接口的调用Query参数都需要企业内部应用的access_token

在这里插入图片描述

在获取access_token前，需要在开发者后台查看应用的AppKey和AppSecret

在这里插入图片描述

请求方式：GET

请求地址：https://oapi.dingtalk.com/gettoken

在这里插入图片描述

在测试中获取到了access_token，但是在后续获取部门信息时有可能存在没有权限的问题

 	/**
     * 获取部门列表
     */
    @Override
    public void getDepartmentList() throws ApiException {
        //从缓存中获取access_token
        String access_token = (String)CacheUtils.get("access_token");
        //判断access_token是否为空
        if (StringUtils.isEmpty(access_token)){
            //为空先获取access_token
            DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
            OapiGettokenRequest request = new OapiGettokenRequest();
            request.setAppkey(appKey);
            request.setAppsecret(appSecret);
            request.setHttpMethod("GET");
            OapiGettokenResponse response = client.execute(request);
            String repBody = response.getBody();
            log.info("access_token获取成功返回信息为："+repBody);
            JSONObject repObj= JSONObject.parseObject(repBody);
            access_token = repObj.getString("access_token");
            //将access_token放入缓存中
            CacheUtils.put("access_token",access_token);
        }
        //获取部门列表
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/v2/department/listsub");
        OapiV2DepartmentListsubRequest req = new OapiV2DepartmentListsubRequest();
        req.setDeptId(1L);
        req.setLanguage("zh_CN");
        OapiV2DepartmentListsubResponse rsp = client.execute(req, access_token);
        log.info("获取部门列表返回信息为："+rsp.getBody());
    }

在这里插入图片描述

提示没有调用该接口的权限，接口权限申请参考：https://open.dingtalk.com/document/orgapp-server/add-api-permission

在钉钉开放平台应用开发-应用下的权限管理搜索关键字，进行申请。

在这里插入图片描述

我这边点击申请后，状态变为已开通

在这里插入图片描述

就可以查询到相关部门信息

在这里插入图片描述

玩美乄暇
关注
Java中对接钉钉API获取数据流程
BADAO_LIUMANG_QIZHI的博客
02-25 6374
场景 需要做后台管理系统，接入钉钉API获取人员、考勤、审批等相关数据。 实现 钉钉开放平台应用开发文档 https://developers.dingtalk.com/document/app 首先需要联系钉钉的管理员，登录钉钉的后台，然后按照开发平台的文档指示 首先创建应用 然后填写应用的基本信息 让管理员创建应用的目的就是为了获取下面这两个AppKey和AppSecret 使用管理员登录钉钉管理平台并创建应用后，就是为了获取上面的AppKey和AppSe...
JAVA对接钉钉
weixin_39388918的博客
06-01 1843
JAVA对接钉钉
JAVA 对接钉钉API（人员、部门、官方智能工作流）20210527
zhua.er的博客
05-27 1万+
前言 应公司要求，公司人事HR系统需要对接钉钉考勤数据，所以需要获取钉钉的打卡记录、出差、外出、请假、调岗的数据，然后转换成HR系统数据。 对接前准备 创建应用 1、首先需要管理员登录钉钉开放平台，创建应用。 说明只有管理员和子管理员可登录开发者后台。 钉钉开放平台：https://developers.dingtalk.com/?spm=ding_open_doc.index.0.0.48134a97aoO7jb 2、在应用开发页面，选择企业内部开发，然后单击创建应用...
Java中控考勤机考勤数据获取以及监听打卡
08-10
中控（ZK）考勤机考勤数据统计获取以及指纹打卡监听： Demo使用方法： 1、需要使用1.7版本32位jdk； 2、需要将Demo中的jacob-1.17-M2-x86.dll文件放到jdk的bin目录下，再将jdk中的其余dll文件放在C:\Windows\System32目录下；64位系统需要放在C:\Windows\SysWOW64目录下，保险起见可以选择两个目下都放入dll文件。 3、用管理员身份运行cmd，输入：regsvr32 C:\Windows\SysWOW64\zkemkeeper.dll 完成注册； 4、然后就可以完美运行Demo
钉钉 Python 脚本配置全攻略：AppKey/AppSecret/ChatID/UserID 获取指南
最新发布
zengliguang的专栏
05-23 1068
要获取钉钉 API 所需的配置信息（如 APPKEY、APPSECRET 等），需要在钉钉开放平台进行相应操作。这样你的脚本就能正常访问钉钉 API 并下载文件了。这是本地文件下载目录，无需从钉钉获取。
引导徒弟找到用java程序拉取钉钉考勤记录的方法
qq_37372909的博客
10-31 478
公司安排了师带徒任务，两个徒弟都满了一年了，基本具备独立上手的能力。但他们跟我当年一样，缺乏系统性思维，不知道体系化的思路。所以，借着公司安排给他们的拉取钉钉考勤记录的任务，我记录分享一下引导他们找到合适方案的过程。
java实现获取钉钉的签到记录
qq_34187522的博客
08-24 2772
java实现获取钉钉签到记录
钉钉企业应用开发demo-java
03-29
【钉钉企业应用开发demo-java】是一个以Java编程语言实现的示例项目，它主要展示了如何集成和使用钉钉开放平台的各种接口来构建企业级应用。这个项目对于开发者，特别是那些想要了解或深入钉钉API集成的Java程序员来...
OA仿钉钉考勤H5源代码
05-24
3. 钉钉API集成：为了实现与钉钉相似的功能，开发者可能调用了钉钉开放的API接口，如获取用户信息、打卡记录、审批流等，以便与钉钉的账号系统和服务进行对接，实现数据同步。 4. 后端服务：虽然主要讨论的是前端源...
DtJava（钉钉 Java SDK），DingTalk（钉钉）的后端开发SDK。.zip
03-03
DtJava，全称为DingTalk Java SDK，是阿里巴巴钉钉官方为开发者提供的一款用于集成钉钉后端服务的Java开发工具包。它使得开发者可以方便地在Java环境中调用钉钉的各项API，进行企业应用的开发和维护，如实现自动化...
钉钉考勤打卡功能分析
03-19
### 钉钉考勤打卡功能的工作原理与实现分析 #### 1. 获取访问令牌 (Access Token) 钉钉开放平台提供了基于OAuth2的标准认证机制，开发者需要通过`AppKey`和`AppSecret`向钉钉服务器请求获取`Access Token`。此令牌...
获取钉钉考勤机的打卡记录并且解析
09-12
钉钉突然改接口了，直接获取是被拒绝了，加了分页限制，加了人数限制，头大，之前得方法不能用了，重新写了版，最多一次获取50个人的考勤，并且这些人的考勤记录一次只能获取50条，我想了个办法中心思想就是首先拆分公司人员的dingId的列表，拆成每50个一组，然后限制分页最大50个每页，50个人的打卡记录肯定大于最大限制，每次获取返回的考勤记录判断它给返回的hasMore是不是true是的话还将这50个人作为条件，偏移量加50，查询下一部分的考勤记录，如果是false则说明已经获取这50个人的全部数据，那么则将之后的50个人作为新的条件，继续以上判断，如果大家有更好的方法欢迎来留言，学习一下。
钉钉获取打卡记录传入数据库（python）
07-25
钉钉API考勤打卡记录获取并存入数据库（python）,免去人数限制
简单粗暴：Java实现异常通知到手机钉钉
q2450751976的博客
01-16 2064
应用场景：当项目在运行时如发生异常，可实时在手机钉钉上查看。 如果您的项目是SpringBoot 可以配合 异常处理AOP。SpringBoot实现自定义注解处理异常 。实现异常后自动报警到钉钉。 第一步：获取钉钉的token 和 secret 首先登录钉钉PC，随便找一个群组，点击右上角··· --》点智能群助手--》点添加机器人--》添加机器人--》自定义--》添加 随便取个名字...
java_专有钉钉获取组织架构以及人员
weixin_45059961的博客
09-04 1689
【代码】java_专业钉钉获取组织架构以及人员。
钉钉企业内部应用 - 获取考勤打卡结果
热门推荐
Chon.Wang
07-07 3万+
本文是根据钉钉官方文档归纳所出，最后有 PHP 测试成功的 demo。 概述 钉钉登录是基于 OAuth2.0 协议标准构建的钉钉 OAuth2.0 授权登录系统。 在进行钉钉 OAuth2.0 授权登录接入之前，需要先创建一个应用，并获得相应的 AgentId 和 AppSecret。 OAuth2.0 授权说明 钉钉 OAuth2.0 授权登录让钉钉用户使用钉钉身份安全登录第三方应用或网站，在钉钉用户授权登录已接入钉钉 OAuth2.0 的第三方应用后，第三方可以获取到用户的接口调用凭证 .
钉钉小程序 没有调用该接口的权限
qubes的专栏
02-20 1924
钉钉小程序 没有调用该接口的权限。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值