概述 MQTT 是一种基于发布/订阅模式的通讯协议,该协议构是轻量、简单、 开放,是低开销、低带宽占用的即时通讯协议。 实名制考勤设备接口要求采用 MQTT 协议,协议版本为 v3.1.1。 本文档主要用于实名制考勤设备和实名制平台交互数据的 mqtt 协 议文档, 主要适用于集成开发与维护人员。
通讯协议说明
MQTT 主题 Topic 主要有下面几个: mqtt/CODE/ID 指令下发主题, 考勤设备订阅,接收到之后处理命令; 同时处理 mqtt 发送过来的回复信息 mqtt/CODE/ID/Ack 指令回复主题, 考勤设备处理指令后,返回值发往该主题 mqtt/CODE/ID/Rec 考勤机考勤记录发往该主题 mqtt/CODE/heartbeat 考勤机心跳通知发往该主题 mqtt/CODE/basic 上线,离线通知发往该主题 其中 CODE 表示对接厂商的代码; ID 表示考勤设备的唯一 ID 号 (ID 由厂商固定 3 位前缀码+大写字母数字组成的,最长 56 位);唯一 ID 不建议太复杂,后续平台绑定要输入 每个对接厂商申请后,实名制平台会提供一个固定的代码 CODE + 设备 ID 前缀码 + MQTT 信息(地址,账户和密码) + 实名制平台公钥; 同时厂商需随机生成一个 RSA 密钥对,并将公钥提供给实名制平台, 私钥设备自己保留,用于加签 Mqtt 数据载体来回传输的数据格式均为标准的 JSON 格式; MQTT 连接的 clientID 需要和 mqtt/CODE/ID 中的 ID 一致,注意前缀 也需要添加.
3实名制考勤设备设置要求 实名制考勤设备需要提供配置 MQTT 中心服务器地址、端口、账号、 密码和唯一 ID 等参数的方式;需要提供 mqtt 主题 topic 的配置功能,允 许自定义 mqtt 主题
测试环境 开发测试环境中,MQTT 服务可以使用 apache-apollo 或者 Rabbitmq mqtt 来搭建; MQTT 客户端工具可以使用 MQTTX、mqttbox 等工具
指令接口
指令下发是实名制平台(或手动测试)往 MQTT 中心 mqtt/CODE/ID 主
题发送,考勤设备根据接收到该消息来处理指令
指令回复是考勤设备往MQTT中心mqtt/CODE/ID/Ack主题发送内容.
部分内容由用户投稿或者来源于网络，如有侵权，请联系底部邮箱进行删除！非常感谢您的支持！
