企业内部开发 服务端API 打卡 为打卡人员补卡
为打卡人员补卡
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
为打卡人员补卡
最后更新:2023/11/30

 

请求方式: POST(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/checkin/punch_correction?access_token=ACCESS_TOKEN

请求示例:

{
   "userid": "zhangsan",
   "schedule_date_time": 1654444800,
   "schedule_checkin_time": 32400,
   "checkin_time": 1654486827,
   "remark": "备注信息"
}

参数说明:

参数类型是否必须说明
access_tokenstring调用接口凭证
useridstring需要补卡的成员userid
schedule_date_timeuint32应打卡日期,为当天0点的Unix时间戳。
schedule_checkin_timeuint32应打卡时间点,相对应打卡日期0点的偏移秒数,如9点整则为32400。可通过获取员工打卡规则获取对应的规则打卡时间点,如work_sec/off_work_sec。
对于没有规则对应的打卡时间点,如休息日打卡、无规则打卡、自由上下班,该参数不用填。
checkin_timeuint32实际打卡时间,Unix时间戳。相对于schedule_checkin_time的实际打卡时间,具体可以表现为正常/迟到/早退
remarkstring备注信息
不超过512字节

 

权限说明:
调用的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「打卡 - 可调用接口的应用」中
代开发应用暂不支持
第三方应用暂不支持

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

 

调用频率:
接口调用频率限制为600次/分钟

返回结果:

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
上一篇
为打卡人员排班
下一篇
添加打卡记录