智慧硬件开发
智慧硬件开发
硬件云端接入
考勤/门禁设备
接口调用
上报考勤打卡记录
上报考勤打卡记录
最后更新:2025/09/08
上报企业人员在设备的考勤打卡记录,每次可批量上报100条记录。
注意
① 接口上报后只会产生考勤打卡记录,如果设备还有拥有门禁能力,则需要再调用上报门禁通行记录接口
② 接口会检查上报人员是否在设备可见范围:若不在设备可见范围,则该记录上报失败
③ 接口会对绑定企业进行天级别的打卡人次频率限制:若企业超频,则接口报错
④ 接口会对打卡人员进行小时级别的打卡频率限制:若打卡人员超频,则该条记录上报失败

 

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_checkin_data?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:

{
	"checkin_data": [
		{
			"open_userid": "x1",
			"user_type":0,
			"timestamp": 12345
		},
		{
			"open_userid": "x2",
			"user_type":0,
			"timestamp": 12345
		}
	]
}

参数说明:

参数名是否必须类型描述
device_access_tokenstringdevice_access_token ,获取方式见获取设备调用凭证
checkin_dataarray(data)打卡数据,最多批量上报100条数据
checkin_data.open_useridstring打卡用户的open_userid
checkin_data.user_typeuint32用户类型:0-企业成员;2-学生
checkin_data.timestampuint32打卡时间戳

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"fail_list": [
		{
			"open_userid":"x2",
			"user_type":0,
			"timestamp":12345
		}
	]
}

参数说明:

参数名描述
errcode错误码。若errcode不为0,则表示整个接口调用失败
errmsg错误码描述
fail_list上报失败列表。若err_code为0,但fail_list不为空,则部分数据上报失败
上一篇成员绑定硬件设备
下一篇上报体温检测记录
    本节内容
硬件直连接入
更新日志
联系我们