登录
基础
连接微信
办公第三方应用获取企业已授权的考勤机打卡记录。
注意：
1.第三方应用须具有“设备接口信息权限-考勤打卡原始数据”授权；
2.企业须同时安装硬件设备和第三方应用；
3.企业须向第三方应用二次授权 具体硬件设备的原始数据；
4.仅返回应用可见范围内的成员打卡数据；
5.接口返回数据按照打卡记录上传时间排序；
6.请求时间跨度应在一个月内，并且跨月请求易返回重复数据，请尽量避免；
7.部分场景下，接口可能返回重复的打卡数据，调用端应进行排重。
请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_checkin_data?access_token=ACCESS_TOKEN
请求包体：
{
"user_type": 0,
"begin_time":12345,
"end_time":67890,
"data_filter_type": 1,
"device_sn_list":["SN1", "SN2"],
"cursor":"CURSOR",
"limit":"LIMIT",
"agentid":10000
}参数说明：
| 参数名 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| access_token | 是 | string | 应用调用接口权限 |
| user_type | 是 | uint32 | 成员类型，0-企业成员，2-学生 |
| begin_time | 是 | uint32 | 表示设备上传记录的开始时间戳 |
| end_time | 是 | uint32 | 表示设备上传记录的结束时间戳，时间跨度不超过一个月 |
| data_filter_type | 是 | uint32 | 打卡数据筛选条件，1-按设备sn进行筛选，该条件下device_sn_list必填，并忽略输入的openuserid；2-按成员openuserid进行筛选，该条件下open_userid_list必填，并忽略传入的device_sn_list |
| device_sn_list | 否 | string | 打卡设备SN列表，最多传入100个 |
| open_userid_list | 否 | string | 成员openuserid列表，最多传入100个，须在应用可见范围，否则忽略 |
| cursor | 否 | string | 分页查询游标，上一次调用时返回的next_cursor，初次调用可以不填。调用方需保证cursor的正确性 |
| limit | 否 | uint32 | 分页查询限制，最多可返回limit条数据，不填默认200，最多500 |
| agentid | 否 | uint32 | 应用agentid，第三方套件应用必填，第三方单应用可不填 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"checkindata": {
"items":[
{
"open_userid": "x1",
"checkin_time": 12345,
"device_sn": "SN"
}
]
}
"next_cursor":"NEXT_CURSOR"
}参数说明：
| 参数名 | 描述 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误码描述 |
| checkindata | 打卡数据 |
| checkindata.items.open_userid | 打卡人员open_userid |
| checkindata.items.checkin_time | 打卡时间戳 |
| checkindata.items.device_sn | 打卡设备SN |
| next_cursor | 分页游标，用于实现分页拉取，拉取下一页数据时需将前一页next_cursor填入请求cursor。若有返回该字段且为非空，表示可能还有满足的打卡数据，需继续调用接口；返回空字符串代表已经是最后一页。 由于权限检查等筛选，极端情况下可能checkindata.items返回为空，但后续依旧有满足条件的数据。 |
基础连接微信办公基础连接微信办公基础连接微信办公