智慧硬件开发 硬件直连接入 考勤/门禁设备 云端下发指令 通讯录变更事件
通讯录变更事件
最后更新:2022/09/16
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
通讯录变更事件
最后更新:2022/09/16

本次通讯录变化携带版本号perm_version同时下发,设备再通过调用“增量拉取用户信息”接口获取到具体的变更数据后,把perm_version记录下来。

指令包体:

{
	"cmd" : "push_change_contact",
	"headers": {
      		"req_id" : "xxxx"
  	},
	"body": {
	      "timestamp":1514271983,
	      "perm_version": 5,
               "create_user": [
                   {
                       "userid":"ZangShan",
					   "user_type":0
                   },
                   {
                       "userid":"lisi",
					   "user_type":0
                   }
               ],
               "update_user":[
                   {
                       "userid":"ZangShan01",
					   "user_type":0
                   }
               ],
               "delete_user":[ 
                   {
                       "userid":"ZangShan02",
					   "user_type":0
                   }
               ]
  	}
}

参数说明:

参数名类型描述
req_idstring透传请求的req_id
cmdstring指令号,此处固定为push_change_contact
timestampUint32Unix时间戳(秒)
create_userArray(data)新增成员列表
update_userArray(data)更新成员指纹信息成员列表
delete_userArray(data)删除成员列表
useridString成员id(字符串),长度为1-64个字节
user_typeUint32成员的类型: 0:企业员工 1:访客 2:学生 不填则默认值为0
perm_versionUint32当前云端通讯录版本号,版本号严格递增(每次增加1),当推送版本号跟考勤机版本号之间出现空洞(>=2)时,说明考勤机可能遗漏推送事件,考勤机应记录下来,选择一定的时间全量拉取通讯录。
上一篇
指纹/人脸多算法版本协议
下一篇
成员UserId变更事件