获取考勤打卡原始数据 - 接口文档

开发者中心

首页

教程

接口

社区

工具

第三方应用开发

快速入门服务端API 客户端API 运营规范附录更新日志联系我们

第三方应用开发服务端API 智慧硬件接口调用获取考勤打卡原始数据

获取考勤打卡原始数据

最后更新：2023/10/08

第三方应用获取企业已授权的考勤机打卡记录。

注意：
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返回为空，但后续依旧有满足条件的数据。

获取硬件授权结果

获取温度检测原始数据

本节内容

获取考勤打卡原始数据