可通过此接口,获取考勤设备上产生的所有原始打卡记录,包括未被打卡应用记录的不符合打卡规则的记录。
第三方应用可获取应用可见范围内员工在考勤设备上产生的所有原始打卡记录,包括未被打卡应用记录的不符合打卡规则的记录。
请求方式: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 |
starttime | 是 | Unix时间戳,当filter_type为1时,表示打卡的开始时间;当filter_type为2时,表示设备上传记录的开始时间 |
endtime | 是 | Unix时间戳,当filter_type为1时,表示打卡的结束时间;当filter_type为2时,表示设备上传记录的结束时间 |
useridlist | 是 | 需要获取打卡记录的用户列表 |
1. 获取记录时间跨度不超过一个月
2. 用户列表不超过100个。若用户超过100个,请分批获取
3. 获取的是通过考勤设备打卡的原始记录,不包含企业微信app手机打卡的记录
4. userid无效时,忽略该参数,不报错
权限说明:
返回结果 :
{
"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 | 打卡设备名 |