智慧硬件开发
智慧硬件开发
硬件直连接入
考勤/门禁设备
接口调用
上报考勤打卡/门禁通行记录
上报考勤打卡/门禁通行记录
最后更新:2022/09/16

上报 打卡/通过门禁 数据,若上传失败可以在设备上缓存打卡数据一段时间再重试。打卡/通过门禁 数据最多200条。

 

请求包体:

{
   "cmd":"checkin",
   "headers":
	{
		"req_id":"xxxxx"
	},
	"body":
	{
	 	"checkin_data": [
			{
				"userid": "x1",
				"user_type":0,
				"timestamp": 12345
			},
			{
				"userid": "x2",
				"user_type":0,
				"timestamp": 12345
			},
			{
				"userid": "x3",
				"user_type":1,
				"timestamp": 12345,
				"pass_type":1,
				"pass_method":1
			}
		]
	}
}

参数说明:

参数名是否必须类型描述
req_idstring请求的id,自行保证不会重复即可
checkin_dataArray(data)
timestampUint32Unix时间戳(秒),早于2018年的timestamp会被忽略,即既不入存储,也不报错
useridString成员id。当为访客userid时,参见访客userid规则说明
user_typeUint32成员的类型: 0:企业员工 1:访客 2:学生 不填则默认值为0
pass_typeUint32门禁需要填写通行类型:1:进门 2:出门 3: 无法识别方向 若不填则不会产生门禁通行记录
pass_methodUint32门禁需要填写通行方法:1:人脸 2:二维码 3:远程开门 4:指纹 5: 企业微信扫描设备二维码 6:设备扫描手机二维码

返回结果:

{
	"headers": 
	{
      		"req_id" : "xxxx"
	},
	"body": 
	{
      "fail_list" :
		[
			{
				"userid":"x2",
				"user_type":0,
				"timestamp":12345
			}
		]
	},
	"errcode": 0,
	"errmsg": "ok"
}

参数说明:

参数名描述
req_id透传请求的req_id
user_type成员的类型: 0:企业员工 1:访客 2:学生 不填则默认值为0
pass_type访客需要填写通行类型:1:进门 2:出门
errcode错误码
errmsg错误码描述
fail_list上传失败的记录
注:目前仅处理员工打卡数据,访客/学生数据暂时忽略,但是后续企业微信可能会存储并展示,设备可以先把访客/学生数据上报
上一篇获取访客列表最新版本号
下一篇上报远程开门/扫码开门结果
    本节内容
硬件直连接入
更新日志
联系我们