中控智慧_PUSH通讯协议_V3.4.pdf中控智慧考勤机PUSH通讯协议V3.4，适应于指纹机66

文件名称: 中控智慧_PUSH通讯协议_V3.4.pdf

所属分类: Web开发

开发工具:

文件大小: 1mb

下载次数: 0

上传时间: 2019-09-04

提供者: yanyuf******

下载 (1mb)

不能下载？报告错误

详细说明：中控智慧考勤机PUSH通讯协议V3.4，适应于指纹机660，人脸机iFace702等机型。目录 1摘要 2特点 2.1编码 2.2HTTP协议简介 3定义 4功能 6666789 5流程 6初始化信息交互… 10 7交换公钥(支持通信加密的场合) 8交换因子(支持通信加密的场合) 6 9推送配置信息 .l7 10上传更新信息 8 1上传数据 20 11.1上传方式 20 11.2上传考勤记录 20 11.3上传考勤照片 22 114上传操作记录 11.5上传用户信息 26 11.6上传身份证信息 29 11.7上传指纹模板 118上传面部模板 38 11.9上传指静脉模板. 40 11.10上传一体化模板. 43 11.11上传用户照片 47 11.12上传数据包 11.13上传比对照片 52 12获取命合 121DATA命合 56 122 UPDATA子命合 122.1用户信息 122.2身份证信息 ,q中中中中 57 122.3指纹模板… 60 1224面部模板… 12.2.5指静脉模板.… 122.6一体化模板.… 12.27用户照片 1228比对照片 1229短消息 122.10个人短消息用户列表… 122.11宣传照片 12.2.12工作代码 65 122.13快捷键 66 122.14门禁组.…… 122.15门禁时间表… .67 122.16门禁节假日. 68 122.17门禁多组验证 123 DELETE子命爷… 12.3.1用户信息非,, 12.3.2指纹模板 12.3.3面部模板 70 12.34指静脉模板. 70 12.3.5一体化模板 70 12.3.6用户照片 12.37比对照片 1238短消息… 12.39工作代码. 123.10宣传照片 124 QUERY子命合 2 124.1考勤记录 ·· 124.2考勤照片 1243用户信息… 1244指纹模板. 74 125 CLEAR命合 74 1251清除考勤记录 74 12.52清除考勤照片∴ 75 12.5.3清除全部数据 ./5 126检查命合… 12.6.1检查数据更新. 75 12.62检查并传送新数据 76 1263考勤数据白动校对功能. 76 127配置选项命合…… 76 127.1设置客户端的选项 76 127.2客户端重新刷新选项… .77 127.3发送客户端的信息到服务器 77 128文件命合 77 1281取客户端内的文件 77 128.2发送文件到客户端 78 12.9远程登记命合 80 12.9.1登记用户指纹. 1292登记卡号 1293登记人脸,掌纹(一体化模板) 12.10控制命合 12.10.1重新启动客户端… 12.102输出打开门锁信号. 12.10.3取消报警仨号输出 83 12.11其他命合, 12.11.1执行系统命合…… 1211.2在线升级 83 12.113后台验证 13命合回复… 14异地考勤 15附录 911 15.1附录1 152附录2 153附录3 154附录4. .94 155附录5 156附录6 95 157附录7 158附录8 1摘要 Push协议是基于超文本传输协议(HTTP)的基础上定义的数据协议,建立在TCPP连接上,主要应用于中控考勤、门埜等设备与服务器的数据交互,定义了数据(用户信息、生物识别模板、考勤记录等)的传输格式、控制设备的命令格式;日前中控支持的服务器有WDMS、 ZKECO、 ZKNET ZKBioSecurity3.0等,第三方支持的服务器有印度ESSL等 2特点 ●新数据主动上传 ●断点续传 ●所有行为都由客户端发起,比如上传数据、服务器下发的命令等 2.1编码协议中传输的数据大部分都是ASC字符,但是个别的字段也涉及到编码的问题,比如用户姓名,所以对该类型数据做如下规定 ●为中文时,使用GB2312编码为其他语言时,使用UTF-8编码日前涉及到该编码的数据如下 ●用户信息表的用户姓名 ●短消息表的短消息内容 22HTTP协议简介 Push协议是基于HTTP协议的基础上定义的数据协议,这里简单介绍下什么是HTTP协议,如果已绎熟悉可跳过此部分。 HTTP协议是一种请求/响应型的协议。客户端给服务器发送请求的格式是一个请求方法(request method),UR,协议版本号,然后紧接着一个包含请求修饰符( modifiers),客户端信息,和可能的消息主体的类MME(MME-ike)消息、。服务器对请求端发送响应的格式是以一个状态行( status ine),其后跟随一个包含服务器信息、实体元信息和可能的实体主体内容的类MME(MME-ike)的消息。其中状态行( status line)包含消息的协议版本号和一个成功或错误码。如下例子客户端请求: Gethttp113.108.97.187:8081/iclock/accounts/login/?next=/iclock/dataliclock/http:/1.1 User-Agent: Fiddler Host:113.10897.187:808 服务器响应 Http/1.1 200 ok Server: nginx/0.8.12 Date fri. 10 Jul 201503: 53: 16 GMT Content-Type: text/html; charset=utf-8 Transfer-Encoding: chunked Connection: close Content-Language: en Expires: Fri, 10 Jul 2015 03: 53: 16 GMT Vary: Cookie, Accept-Language Last-Modified Fri. 10 Jul 201503 53: 16 GMT ETag: c487be90924810a8c2e293dd7f5b0ab4 Pragma: no-cache Cache-Control: no-store Set-Cookie: csrftoken=60fb55cedf203c197765688ca2d7bfge; Max-Age=31449600; Path=/ Set-Cookie: sessionid=06d37fdc8f36490c70laf2253af79f4a: Path=/ HTTP通信通常发生在TCP∥P连接上。默认端口是TCP80,不过其它端口也可以使用。但并不排除 HTTP协议会在其它协议之上被实现。HTTP仅仅期望的是一个可靠的传输(译注:HTTP一般建立在传输层协议之上);所以仼何提供这种保证的协议都可以被使用。 3定义文档屮引用定义使用格式为:$ Servere} ● Server|P:服务器|P地址 ● Server Port:服务器端口 ●XXX:未知值 ● Value1 VValue2W∨ae3. Valuer:值1值2值3.值n ● Required:必须存在 ● Optional:可选 ● Serial| Number:系列号(可以为字母、数字、字母+数字组合) ●NUL:nul(0) ●sP:空格 ●LF:换行符(n) ●HT:制表符(lt ● Data record:数据记录 ● CreCord:命令记录 ●Cmd|D:命令绵号 ● Cmd Desc:命令描述 ●Pin:工号 ●Time:考勤时间 ● Status:考勤状态 ● verify:验证方式 ● Workcode: workcode编码 ● Reserved:预留字段 ● OpType:操作类型 ● OpWho:操作者 ● OpTime:操作时间 ● Binary Data:二进制数据流 ● Tablename:数据表名 ● SystemCmd:系统命令 ●Key:键 ●∨a|ue 值 ● File Path:文件路径 ●URL:资源位置 4功能客户端的角度来描述Push协议支持的功能 ●初始化信息交互 ●推送配置信息上传更新信息上传数据 ●获取命令命令回复 ●异地考勤 5流程使用Push协议的客户端和服务器,必须由客户端先发起“初始化信息交互”请求成功之后,才能使用其他功能,比如上传数据、获取服务器命令、上传更新信息、回复服务器命令等,其中这些功能并没有先后顺序,取决于客户端应用程序的开发,如下图 Http Push协议流程图 1.设各启动时,从原务器上读取设备的配置信息 GET / clock/cdata?SN=918291029 &c options=all GET OPTION FROM 1234567 Stamp=82983982 OpStamp=9238883 2.设备每隔指定时间(*秒)主动向服务器读取命令 GET clock/getrequest'sN=918291029 C: 122. INFC C- 123 DATAUSER PIN=S2 Nam e=Richard 3.设备执行命令后,把结果返回服务器 POST /clock devicecm dsN=918291029 设备检查到有新的置记数据和考勤记录时,把它们传送到服务器 POST clock/edata? SN=1234567&stamp=26 OK 6初始化信息交互客户端发起请求,将相应的配置信息发送给服务器,服务器接收到该请求,将相应的配置信息回复给客户端,只有当客户端获取到相应的置信息,才能算交互成功:配置信息交互是按照规定好的格式进行的,具体如下客户端请求消息 GET/clock/cdata? SN=$ SerialNumber)&options =all &pusher=sXXX]&language=SXXX)&pushcom mkey=sxxxhttp:/1.1 Host: $ServerIP]: $(ServerPort 注释 HTTP请求方法使用:GET方法 UR使用:/ clock/cdata HTTP协议版本使用:1.1 客户端配置信息: SN:${ Require卟}表示客户端的序列号 options:${ Required}表示获取服务器配置参数,日前值只有all pusher: OPtional}表示设备当前最新的push协议版本,新开发的客户端必须支持且必须大于等于 22.14版本,详见(附录6) anguage:${ρ Optional}表示客户端攴持的语言,新开发的客户端最好攴持,服务端可通过该参数知道日前设备是什么语言,见(附录2) pushcommkey:$ Optional}表示客户端与服务器绑定的密文信息,软件通过此密文判断设备是否经过授权,不同设备值一般是不一样的,该参数需要服务器支持之后,客户端才需支持 Host头域:${ Required} 其他头域:${ Optiona} 服务器正常响应 Http/1.1 200 ok Date:$ⅨXXX} Content-Length: SXXX

(系统自动生成,下载前可以参看下载内容)