dingtalk.oapi.attendance.getleaveapproveduration (计算请假时长)

钉钉考勤微应用,提供了排班的功能,企业管理员可以设置排班规则,该接口可以自动根据排班规则统计出每个员工的请假时长,进而可以与企业自有的请假/财务系统对接,进行工资统计,如果您的企业使用了钉钉考勤并希望依赖考勤系统自动计算员工请假时长,可选择使用此接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userid String 必须 zhangsan 员工在企业内的UserID,企业用来唯一标识用户的字段。
from_date Date 必须 2016-03-09 11:11:11 请假开始时间
to_date Date 必须 2016-03-10 11:11:11 请假结束时间

响应参数

名称 类型 示例值 描述
result ApproveDurationForTopVo result
  • └ duration_in_minutes
  • Number
  • 0
  • 请假时长(单位分钟)
errcode Number 0 errcode
errmsg String ok errmsg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getleaveapproveduration");
OapiAttendanceGetleaveapprovedurationRequest req = new OapiAttendanceGetleaveapprovedurationRequest();
req.setUserid("zhangsan");
req.setFromDate(StringUtils.parseDateTime("2016-03-09 11:11:11"));
req.setToDate(StringUtils.parseDateTime("2016-03-10 11:11:11"));
OapiAttendanceGetleaveapprovedurationResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "result":{
        "duration_in_minutes":0
    },
    "errcode":0,
    "errmsg":"ok"
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部