钉钉开发文档

查询请假状态

更新时间: 2019-6-26

该接口用于查询指定企业下的指定用户在指定时间段内的请假状态。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/attendance/getleavestatus?access_token=ACCESS_TOKEN
参数说明:

名称 类型 是否必须 示例值 描述
userid_list String 必须 123,121 待查询用户id列表,支持最多100个用户的批量查询
start_time Number 必须 1538323200000 开始时间 ,UNIX时间戳,支持最多180天的查询
end_time Number 必须 1538323200000 结束时间 ,UNIX时间戳,支持最多180天的查询时间
offset Number 必须 0 分页偏移,非负整数
size Number 必须 20 分页大小,正整数,最大20

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getleavestatus");
OapiAttendanceGetleavestatusRequest req = new OapiAttendanceGetleavestatusRequest();
req.setUseridList("123,121");
req.setStartTime(1538323200000L);
req.setEndTime(1546358399000L);
req.setOffset(0L);
req.setSize(10L);
OapiAttendanceGetleavestatusResponse rsp = client.execute(req, accessToken);
System.out.println(rsp.getBody());

返回结果

{
    "errmsg":"OK",
    "errcode":0,
    "result":{
        "has_more": false,
        "leave_status":[
            {
                    "duration_unit":"percent_day",
                    "duration_percent":100,
                    "end_time":1538323200000,
                    "start_time":1538323200000,
                    "userid":"manager7580"
            }
        ]
    },
    "success":true
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
result
└ has_more 是否有更多数据
└ leave_status 请假状态列表
└└ duration_unit 请假单位:“percent_day”表示天,“percent_hour”表示小时
└└ duration_percent 假期时长*100,例如用户请假时长为1天,该值就等于100
└└ end_time 请假结束时间,时间戳
└└ start_time 请假开始时间,时间戳
└└ userid 用户id
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!