dingtalk.oapi.attendance.approve.check (审批通过后进行补卡操作)

该接口提供了重新为某个卡点进行打卡的能力。在某个卡点缺卡,早退,迟到等异常情况下企业内部或者isv审批单通过后,调用该接口,可以重新用审批单里指定的时间进行一次打卡

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userid String 可选 dd_dd 员工的user_id
work_date String 可选 2019-08-15 要补哪一天的卡,注意这个日期不是实际要补的日期,而是班次的日期。例如用户要补卡的时间是2019-08-16 00:20,排班时间是2019-08-15 23:50,那么这里要传的日期是2019-08-15
punch_id Number 可选 12345 要补的排班id
punch_check_time String 可选 2019-08-15 08:00 排班时间
user_check_time String 可选 2019-08-15 07:59 用户打卡时间
approve_id String 可选 aasdv13124 审批单id,全局唯一
jump_url String 可选 https://xxx.xxx 审批单跳转地址
tag_name String 可选 补卡 审批单名称

响应参数

名称 类型 示例值 描述
errcode Number 0 0代表成功,其他代表失败
errmsg String 872995737 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/approve/check");
OapiAttendanceApproveCheckRequest req = new OapiAttendanceApproveCheckRequest();
req.setUserid("dd_dd");
req.setWorkDate("2019-08-15");
req.setPunchId(12345L);
req.setPunchCheckTime("2019-08-15 08:00");
req.setUserCheckTime("2019-08-15 07:59");
req.setApproveId("aasdv13124");
req.setJumpUrl("https://xxx.xxx");
req.setTagName("补卡");
OapiAttendanceApproveCheckResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "errcode":0,
    "errmsg":"872995737"
}

异常示例

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

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部