咨询电话 010-81359550或访问网站www.zksps.com联系我们留言
获取完整版开发包和通讯协议
考勤 PUSH 通讯协议
PUSH SDK
文档版本：Custom-V4.3 日期：2021年 12月
push 协议版本：V2.4.2
1
1
目录
1 摘要.................................................................................................................................................................. 6
2 特点.................................................................................................................................................................. 6
2.1 编码....................................................................................................................................................... 6
2.2 HTTP协议简介..................................................................................................................................... 6
3 定义.................................................................................................................................................................. 7
4 功能.................................................................................................................................................................. 8
4.1 混合识别协议规范说明....................................................................................................................... 9
5 流程................................................................................................................................................................ 10
6 初始化信息交互............................................................................................................................................ 11
7 交换公钥（支持通信加密的场合）............................................................................................................ 18
8 交换因子（支持通信加密的场合）............................................................................................................ 19
9 推送配置信息................................................................................................................................................ 19
10 上传更新信息..............................................................................................................................................22
11 心跳..............................................................................................................................................................24
12 上传数据......................................................................................................................................................25
12.1上传方式.............................................................................................................................................26
12.2 上传考勤记录...................................................................................................................................26
12.3 上传考勤照片...................................................................................................................................28
12.4 上传操作记录...................................................................................................................................30
12.5 上传用户信息...................................................................................................................................32
12.6 上传身份证信息(仅人证协议支持)................................................................................................35
12.7 上传身份证考勤记录(仅人证协议支持)........................................................................................39
12.8 上传身份证考勤照片(仅人证协议支持)........................................................................................41
12.9 上传指纹模板...................................................................................................................................43
12.10 上传面部模板................................................................................................................................ 47
12.11 上传指静脉模板............................................................................................................................ 50
12.12 上传一体化模板............................................................................................................................ 53
12.13 上传用户照片................................................................................................................................ 57
12.14 上传数据包.................................................................................................................................... 59
12.15 上传比对照片(仅可见光设备支持)..............................................................................................61
12.16 上传异常日志................................................................................................................................ 64
2
13 获取命令......................................................................................................................................................66
13.1 DATA命令.........................................................................................................................................67
13.2 UPDATA 子命令............................................................................................................................. 67
13.2.1 用户信息............................................................................................................................... 68
13.2.2 身份证信息(仅人证协议支持).............................................................................................71
13.2.3 指纹模板............................................................................................................................... 74
13.2.4 面部模板............................................................................................................................... 74
13.2.5 指静脉模板........................................................................................................................... 75
13.2.6 一体化模板........................................................................................................................... 75
13.2.7 用户照片............................................................................................................................... 76
13.2.8 比对照片(仅可见光设备支持).............................................................................................76
13.2.9 短消息................................................................................................................................... 77
13.2.10 个人短消息用户列表......................................................................................................... 78
13.2.11 宣传照片............................................................................................................................. 78
13.2.12 工作代码............................................................................................................................. 79
13.2.13 快捷键................................................................................................................................. 79
13.2.14 门禁组................................................................................................................................. 80
13.2.15 门禁时间表......................................................................................................................... 81
13.2.16 门禁节假日......................................................................................................................... 82
13.2.17 门禁多组验证..................................................................................................................... 82
13.2.18 身份证黑名单(仅人证协议支持)...................................................................................... 82
13.2.19 身份证白名单(仅人证协议支持)...................................................................................... 85
13.3 DELETE 子命令..............................................................................................................................87
13.3.1 用户信息............................................................................................................................... 87
13.3.2 指纹模板............................................................................................................................... 88
13.3.3 面部模板............................................................................................................................... 88
13.3.4 指静脉模板........................................................................................................................... 88
13.3.5 一体化模板........................................................................................................................... 89
13.3.6 用户照片............................................................................................................................... 89
13.3.7 比对照片(仅可见光设备支持).............................................................................................89
13.3.8 短消息................................................................................................................................... 90
13.3.9 工作代码............................................................................................................................... 90
3
13.3.10 宣传照片............................................................................................................................. 90
13.3.11 身份证黑名单(仅人证协议支持)...................................................................................... 91
13.3.12 身份证白名单(仅人证协议支持)...................................................................................... 91
13.4 QUERY 子命令............................................................................................................................... 91
13.4.1 考勤记录............................................................................................................................... 92
13.4.2 考勤照片............................................................................................................................... 92
13.4.3 用户信息............................................................................................................................... 92
13.4.4 指纹模板............................................................................................................................... 93
13.4.5 一体化模板........................................................................................................................... 93
13.5 CLEAR命令...................................................................................................................................... 94
13.5.1 清除考勤记录....................................................................................................................... 94
13.5.2 清除考勤照片....................................................................................................................... 95
13.5.3 清除全部数据....................................................................................................................... 95
13.5.4 清除一体化模板................................................................................................................... 95
13.6 检查命令...........................................................................................................................................96
13.6.1 检查数据更新....................................................................................................................... 96
13.6.2 检查并传送新数据............................................................................................................... 96
13.6.3 考勤数据自动校对功能....................................................................................................... 96
13.7 配置选项命令...................................................................................................................................97
13.7.1 设置客户端的选项............................................................................................................... 97
13.7.2 客户端重新刷新选项........................................................................................................... 97
13.7.3 发送客户端的信息到服务器............................................................................................... 98
13.8 文件命令...........................................................................................................................................98
13.8.1 取客户端内的文件............................................................................................................... 98
13.8.2 发送文件到客户端............................................................................................................... 98
13.9 远程登记命令................................................................................................................................ 101
13.9.1 登记用户指纹..................................................................................................................... 101
13.9.2 登记卡号............................................................................................................................. 101
13.9.3 登记人脸，掌纹（一体化模板）..................................................................................... 102
13.10 控制命令...................................................................................................................................... 102
13.10.1 重新启动客户端...............................................................................................................102
13.10.2 输出打开门锁信号...........................................................................................................103
4