Springboot整合并调用钉钉SDK

在做企业内部考勤的时候需要调取钉钉的打卡和考勤信息,这里写一下调用的测试方法

首先是官方的文档连接 - >

https://developers.dingtalk.com/document/app/server-api-overview

获取钉钉的APP_KEY

public static String APP_KEY = "企业申请的KRY";

获取钉钉的APP_SECRET

public static String APP_SECRET = "企业申请的秘钥";

拿到上面的内容使我们就可以去看API进行接口调用

当然 , 前提是要先下载并配置好钉钉的maven或者下载jar

我们就先以钉钉提供的获取指定日期用户考勤数据为例子

首先 要通过上面两个变量获取钉钉的Token认证

/**
     * 不通过redis的方式获取 钉钉的token认证
     *
     * @author NEON
     * @date 2021/5/26 19:17
     */
    public static String getAccessToken(){
        String token = null;
        try {
            DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
            OapiGettokenRequest request = new OapiGettokenRequest();
            request.setAppkey(APP_KEY);
            request.setAppsecret(APP_SECRET);
            request.setHttpMethod("GET");
            OapiGettokenResponse response = client.execute(request);
            token = response.getAccessToken();
        } catch (Exception e) {
            e.printStackTrace();
        }
        return token;
    }

直接封装成Util类

然后 , 我们通过文档提供的案例调用方法

/**
     * @description -> 获取指定日期用户考勤数据
     * @author NEON
     * @date 2021/5/26 10:54
     */
    public static String getUserAttendanceDetails() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getupdatedata");
        OapiAttendanceGetupdatedataRequest req = new OapiAttendanceGetupdatedataRequest();
        req.setUserid("你要传入的钉钉ID");
        req.setWorkDate(StringUtils.parseDateTime("2021-04-07 09:00:00"));
        OapiAttendanceGetupdatedataResponse rsp = client.execute(req, getAccessToken());
        System.out.println(rsp.getBody());
        return rsp.getBody();
    }

然后我们查看获取的结果

{
    "errcode": 0,
    "result": {
        "approve_list": [],
        "attendance_result_list": [{
            "check_type": "OffDuty",
            "class_id": 11111111,
            "group_id": 11111111,
            "location_method": "MAP",
            "location_result": "Normal",
            "plan_check_time": "2021-04-07 18:00:00",
            "plan_id": 11111111,
            "record_id": 11111111,
            "source_type": "USER",
            "time_result": "Normal",
            "user_address": "网络科技有限公司",
            "user_check_time": "2021-04-07 22:40:46"
        }, {
            "check_type": "OnDuty",
            "class_id": 11111111,
            "group_id": 11111111,
            "location_method": "MAP",
            "location_result": "Normal",
            "plan_check_time": "2021-04-07 09:00:00",
            "plan_id": 11111111,
            "record_id": 11111111,
            "source_type": "AUTO_CHECK",
            "time_result": "Normal",
            "user_address": "网络科技有限公司",
            "user_check_time": "2021-04-07 08:53:05"
        }],
        "check_record_list": [{
            "base_accuracy": "0.0",
            "base_address": "网络科技有限公司",
            "record_id": 11111111,
            "source_type": "USER",
            "user_accuracy": "11111111.0",
            "user_check_time": "2021-04-07 22:40:46",
            "user_latitude": "11111111.11111111",
            "user_longitude": "11111111.11111111",
            "valid_matched": true
        }, {
            "base_accuracy": "0.0",
            "base_address": "网络科技有限公司",
            "record_id": 11111111,
            "source_type": "AUTO_CHECK",
            "user_accuracy": "11111111.0",
            "user_check_time": "2021-04-07 08:53:05",
            "user_latitude": "11111111.11111111",
            "user_longitude": "11111111.11111111",
            "valid_matched": true
        }],
        "class_setting_info": {
            "rest_time_vo_list": [{
                "rest_begin_time": 11111111,
                "rest_end_time": 11111111
            }]
        },
        "corpId": "11111111",
        "userid": "11111111",
        "work_date": "2021-04-07 09:00:00"
    },
    "success": true,
    "request_id": "11111111"
}

可以看到其实Java调用钉钉API接口是非常方便的