珠海市从业人员实名制管理平台对接协议
珠海市实名制平台对接标准接口
起始位置 | 长度 | 内容说明 | 标记 | 类型 | 备注 |
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 |
二、具体数据包定义
方括号里面的数字为通讯命令，为十进制数字
1. 设备登录系统[823]
位置 | 名称 | 字节数 | 格式 | 说明 |
0-31 | 厂家识别码 | 32 | ASCII | 32 位厂家识别码由腾晖提供，所 有设备一样 |
32-63 | 设备的唯一标识码 | 32 | ASCII | 每台设备的唯一标识 |
64 | 校验和 | 1 | HEX | Xor 校验运算 |
返回值：
成功：flag = 0，验证成功；
失败：flag = 1，Content=用于设备显示的错误提示,UTF-8 编码。设备通讯的其他命令必须在本命令执行成功后，才可以使用。
2. 获取特征信息[824] Content：
返回值：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-3 | 项目编号 | 4 | HEX | 低位在前 |
4-103 | 项目名称 | 100 | UTF-8 | 用于机器显示用 |
数据记录 | 数据记录可以为多条记录，根据每条记录的第一个字节来判断每条记录的 长度和格式 | |||
校验和 | 1 | HEX |
成功：flag = 0，服务端已成功记录此次刷卡操作；返回的内容如下Content：Add
节 | ||||
特征信息长度 （FL） | 4 | Hex | ||
特征信息 | FL | HEX | 人员特征信息，虹膜、人脸 | |
RFID 卡个数 | 2 | HEX | RFID 卡个数，表示 RFID 卡号和手机卡状态重复次数， 为 0 则没有 RFID 卡号和手 机卡状态 | |
RFID 卡号 | 8 | HEX | 手机卡的 RFID 卡号，用于手机刷卡 | |
手机卡状态 | 1 | HEX | 0:正常，1：停机 | |
IC 卡个数 | 2 | HEX | IC 卡个数，表示 IC 卡号重复次数，为 0 则没有IC 卡号 | |
IC 卡号 | 4 | HEX | IC 卡物理卡号,压缩 BCD 码 格式，如有多条则重复 | |
联名卡个数 | 2 | HEX | 联名卡卡号个数，表示联名卡卡号重复次数，为 0 则没有联名卡卡号 | |
联名卡卡号 | 8 | HEX | 联名卡物理卡号,压缩 BCD 码格式，如有多条则重复 | |
备份 | 1 | 备份 |
Content：Del
位置 | 名称 | 字节数 | 格式 | 说明 |
0 | 增加或者删 除标志 | 1 | Hex | 0 为新增用户，1 为删除用 户 |
1-4 | 工人编号 | 4 | HEX | 刷卡成功上传时需要用到 |
若第一个字节为 1 则格式使用Content:Del .
若第一个字节为 0,则格式使用Content:Add.
该命令没一个小时调用一次，设备必须记录每次获取特征信息成功的时间。失败：flag = 1，Content=用于卡机显示的错误提示,UTF-8 编码。
上传刷卡记录[825]
Content：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-3 | 工人编号 | 4 | HEX | |
4-10 | 刷卡时间 | 7 | HEX | BCD 码，年占 2 字节，月、日、 时、分、秒各占一个字节 |
11 | 刷卡模式 | 1 | HEX | 1 表示虹膜，2 表示二代证，3 表示手机卡，4 表示联名卡，5 表示 IC 卡，6 表示人脸 |
12 | 校验和 | 1 | HEX | Xor 校验运算 |
如同时上传多条记录，则Content 内容重复，不包括校验和
返回值：
成功：flag = 0，服务端已成功记录此次刷卡操作；
失败：flag = 1，Content=用于机器显示的错误提示,UTF-8 编码。
3. 获取服务器时间(同步机器时间)[65532]
Content：空
服务端以yyyyMMddhhmmss 的格式返回ASCII 编码的服务器时间字符串。
4. 心跳包：[65535]
Content：空
返回的内容为空。
5. 判断设备是否需要更新[826]
位置 | 名称 | 字节数 | 格式 | 说明 |
0-31 | 设备的唯一标 识码 | 32 | ASCII | 每台设备的唯一标示 |
32-47 | 当前版本号 | 16 | ASCII | 设备当前的版本号，服务器使用 该版本号判断是否需要更新 |
38 | 校验和 | 1 | HEX | Xor 校验运算 |
返回值：
位置 | 名称 | 字节数 | 格式 | 说明 |
0 | 是否需要更 | 1 | ASCII | 0：不需要更新，1：提示更新， |
新 | 倒计时 10 秒，可手动选择，默认 不需要更新 2：强制自动更新，不需要提示 | |||
1-100 | 本次更新内 容描述 | 100 | UTF-8 | 本次更新内容描述 |
101 | 校验和 | 1 | HEX | Xor 校验运算 |
6. 获取更新数据包[827]
位置 | 名称 | 字节数 | 格式 | 说明 |
0-31 | 设备的唯一标识 码 | 32 | ASCII | 每台设备的唯一标示 |
32 | 校验和 | 1 | HEX | Xor 校验运算 |
返回值：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-31 | 软件的MD5 码 | 32 | ASCII | |
32-LEN- 2 | 本次更新的数据 包内容 | LEN-32-1 | HEX | |
LEN-1 | 校验和 | 1 | HEX | Xor 校验运算 |
7. 上传包含勤照片的考勤信息[828]
Content：
位置 | 名称 | 字节数 | 格式 | 说明 |
0-3 | 工人编号 | 4 | HEX | 低位在前 |
4-10 | 刷卡时间 | 7 | HEX | BCD 码，年占 2 字节，月、日、时、分、秒各占一个字节 |
11 | 刷卡模式 | 1 | HEX | 1 表示虹膜，2 表示二代证，3 表示IC 卡，4 表示联名卡，5 表示 IC 卡，6 表示人脸 |
12-15 | 照片长度(PL) | 4 | HEX | 低位在前 |
16- (PL+16-1) | 照片信息 | PL | HEX | 考勤照片的字节数组 |
LEN-1 | 校验和 | 1 | HEX | Xor 校验运算 |
如同时上传多条记录，则 Content 内容重复(不包括校验位)。由于照片的信息较大，一次尽量不要上传太多条的信息。
成功：flag = 0，服务端已成功记录此次刷卡操作；
失败：flag = 1，Content=用于机器显示的错误提示,UTF-8 编码。
8. 上传采集结果[832]
民族 | 4 | ASCII | 代号（参考民族字典） | |
出生日期 | 16 | ASCII | yyyyMMdd(20170409) | |
住址 | 140 | UTF8 | ||
特征信息长度 （PL） | 4 | HEX | ||
特征信息 | PL | HEX | 特征长度为 0，可不传该位 | |
识别度 | 1 | HEX | 0:高，1：低 | |
是否重采，默认 0 | 1 | HEX | 0:是，1:不是 | |
身份证发证机关 | 60 | UTF8 | ||
身份证有效期 | 64 | UTF8 | ||
是否手工 | 1 | HEX | 0 表示刷身份证采集，1 表示手工录入资料 | |
保留 | 99 | HEX | 保留字段，暂时没用 | |
身份证照片长度 （PL） | 4 | HEX | ||
身份证照片 | PL | HEX | ||
采集照片长度 (GL) | 4 | HEX | ||
采集照片 | GL | HEX | 采集照片，根据实际长度发送 | |
校验和 | 1 | HEX | Xor 校验运算 |
返回值：
位置 | 名称 | 字节数 | 格式 | 说明 |
0 | 返回结果 | 1 | HEX | 0:成功，1:失败 |
1-30 | 失败原因 | 30 | UTF-8 | 失败原因 |
31-40 | 保留 | 10 | HEX | 保留字段，暂时没用 |
41 | 校验和 | 1 | HEX | Xor 校验运算 |
■ 通讯方法补充说明：卡机和服务端建立连接后，必须先进行登录[823]， 登录成功后，才能发送其他命令。登录成功后，只要连接没断开，就不需重新登录。
■ 1 位的HEX 请用byte 传输
部分内容由用户投稿或者来源于网络，如有侵权，请联系底部邮箱进行删除！非常感谢您的支持！
