第三方应用开发 服务端API OA 打卡 获取设备打卡数据
获取设备打卡数据

可通过此接口,获取考勤设备上产生的所有原始打卡记录,包括未被打卡应用记录的不符合打卡规则的记录。
第三方应用可获取应用可见范围内员工在考勤设备上产生的所有原始打卡记录,包括未被打卡应用记录的不符合打卡规则的记录。

 

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/hardware/get_hardware_checkin_data?access_token=ACCESS_TOKEN

请求示例:

{
   "filter_type": 1,
   "starttime": 1492617600,
   "endtime": 1492790400,
   "useridlist": ["james","paul"]
}

参数说明:

参数必须说明
access_token调用接口凭证。
filter_type过滤类型,1表示按打卡时间过滤,2表示按设备上传打卡记录的时间过滤,默认值是1
starttimeUnix时间戳,当filter_type为1时,表示打卡的开始时间;当filter_type为2时,表示设备上传记录的开始时间
endtimeUnix时间戳,当filter_type为1时,表示打卡的结束时间;当filter_type为2时,表示设备上传记录的结束时间
useridlist需要获取打卡记录的用户列表
1. 获取记录时间跨度不超过一个月
2. 用户列表不超过100个。若用户超过100个,请分批获取
3. 获取的是通过考勤设备打卡的原始记录,不包含企业微信app手机打卡的记录
4. userid无效时,忽略该参数,不报错

权限说明:

  • 企业需要使用“打卡”secret所获取的accesstoken来调用(获取方式参考:文档-获取access_token);
  • 第三方应用需具有“打卡->获取考勤机打卡原始数据”权限

返回结果 :

{
   "errcode":0,
   "errmsg":"ok",
   "checkindata": [{
		"userid" : "james",
		"checkin_time" : 1492617610,  
		"device_sn" : "xxxxx",    
		"device_name": "xxxx门店"
	},{
		"userid" : "paul",
		"checkin_time" : 1492617620,  
		"device_sn" : "yyyy",   
		"device_name": "yyyy门店"
	}]
}

参数说明:

参数说明
userid用户id
checkin_time打卡时间。Unix时间戳
device_sn打卡设备的sn
device_name打卡设备名
上一篇
为打卡人员排班
下一篇
概述