陇明公平台终端数据接口规范V1.docxVIP

“陇明公”平台终端数据接口规范V1.0 版本信息：V1.0 文档日期：2020-12 目录 TOC \o 1-3 \h \u 一、 概述 4 二、 目的及范围 4 三、 术语定义及缩略语 4 四、 数据包通讯规范 4 4.1通讯方式 4 4.2通讯数据包格式定义 4 五、 数据包内容格式定义 5 5.1设备登录[823] 5 5.2获取白名单[824] 5 5.3上传考勤信息[828] 6 5.4获取特征信息[841] 7 5.5上传包含勤照片及体温的考勤信息[844] 8 5.6获取服务器时间[65532] 9 5.7心跳包[65535] 9 六、 常见问题 9 6.1获取信息长度是用来做什么的，对接的流程是什么 9 6.2关于数字是怎么传输的 9 版本说明 修订人 修订版本 描述 修订时间 修订内容 蒋健 v1.0 2020/12  概述 本终端数据接口规范主要是为考勤设备的供应商与”陇明公”平台进行数据交互对接时使用。 本接口规范以”陇明公”平台数据标准为指导，明确定义了考勤设备数据与”陇明公”平台对接的流程规范以及数据接口规范，用以指导相关对接工作的执行。 本文主要读者为相关厂商的技术人员。 目的及范围 制定本规范的目的是为了统一考勤设备与”陇明公”平台的对接标准； 本规范定义了终端设备登陆、上传采集信息、获取白名单、获取人员特征信息、上传考勤信息，获取服务器时间、上传心跳信息等接口内容。 术语定义及缩略语 下列缩略词适用于本规范： 缩写 中文描述 实名制模块 “陇明公”平台实名制模块 白名单 允许通过考勤设备进行考勤的人员清单 数据包通讯规范 4.1通讯方式 本系统通讯方式采用Socket通讯方式。Socket连接建立后，按照通讯包格式定义组合通讯包。通讯包的请求与响应格式保持一致。 通讯失败：flag = 1，Content=用于卡机显示的错误提示,UTF-8编码。 4.2通讯数据包格式定义 起始位置 长度 内容说明 标记 类型 备注 0 1 开始标记 Header Byte 0x01 1 4 长度 LEN Length Uint 内容的长度 5 4 分包顺序索引 PartIndex Uint 0x00 9 4 分包总数 PartCount Uint 0x00 13 1 版本 Version Byte 默认0x03 14 2 命令 Command Ushort 0x10 16 16 会话标识 SessionID Byte[16] 通讯唯一标识，每一个tcp连接由设备随机生成 32 LEN 内容 Content Byte[LEN] 数据包内容 32 + LEN 1 状态 Flag Byte 0x0为成功，0x01为失败 33 + LEN 1 结束标记 Tail Byte 0x01 数据包内容格式定义 5.1设备登录[823] 说明 备通讯的其他命令必须在本命令执行成功后，才可以使用。 Content 位置 名称 字节数 格式 说明 0-31 厂家识别码 32 ASCII 32位厂家识别码由腾晖提供，所有设备一样 32-63 设备的唯一标识码 32 ASCII 每台设备的唯一标识 64 校验和 1 HEX Xor校验运算 5.2获取白名单[824] 说明 Content： 位置 名称 字节数 格式 说明 0-31 设备的唯一标识码 32 ASCII 每台设备的唯一标识 32-38 该设备最后获取数据时间 7 HEX BCD码，年占2字节，月、日、时、分、秒各占一个字节 39 校验和 1 HEX Xor校验运算 返回值： 位置 名称 字节数 格式 说明 0-3 项目编号 4 HEX 低位在前 4-103 项目名称 100 UTF-8 用于机器显示用 104-104+CL 数据记录CL 数据记录可以为多条记录，根据每条记录的第一个字节来判断每条记录的长度和格式 105+CL - 106+CL 校验和 1 HEX 重复追加的内容 Content：Add 位置 名称 字节数 格式 说明 0 增加或者删除标志 1 Hex 0为新增用户，1为删除用户 1-4 工人编号 4 HEX 刷卡成功上传时需要用到 5-14 工人姓名 10 UTF-8 15-32 身份证号码 18 ASCII 33-62 工作岗位 30 UTF-8 63-69 最后培训时间 7 HEX BCD码，年占2字节，月、日、时、分、秒各占一个字节 70-73 特征信息长度（FL） 4 Hex 固定值0 74-74+FL 特征信息 FL HEX 人员特征信息，根据特长度 74+FL-80+FL 其他 6 80+FL-81+FL 备份 1 备份 Content：De