网关 API 总览

先区分 应用数据接口、Std 转发协议和 管理接口，再确定接入方式。

接口	适用模式	用途	说明
Edge MQTT 原生/兼容应用接口	Edge	终端业务上报、单播、组播下行	主题与 JSON
HTTP POST 推送	Edge	网关向应用服务器上报	URL、请求头、兼容格式
RS485 Modbus / Private	Edge 且硬件支持	PLC/主站读取最新数据，向终端下发	帧与寄存器
UDP / V3 / V4 / Basic Station	Std	网关与外部 NS 之间转发无线帧	Std 转发协议
管理 REST / WebSocket	两种模式；终端/组播仅 Edge	本地网页登录、配置、查询和管理	管理 API
远程管理 MQTT	配置了远程管理连接时	管理平台维护网关和终端	管理 MQTT

同一个 Broker 可以承载不同接口，但主题、数据结构、认证权限和用途仍要分别核对。网关 EUI、终端 DevEUI、DevAddr、组地址和数字序号不是同一个标识。

先实际操作时，可直接按接入示例与联调完成订阅、HTTP 接收、管理登录和本地帧校验。

接入顺序

1. 确认模式、软件版本及接口是否存在。
2. 用一个终端取得真实业务包和 FPort。
3. 先接收上行，保留 Base64 原文、解码字节和时间。
4. 需要下行时，再用现场允许的命令核对终端回复/动作。
5. 分别处理 A 类等待、连接重建、重复消息和错误，不以发送函数返回成功代替终端成功。

接口以《边缘网关接口文档 1.0.6》为基础，结合当前实现补充。旧文档的兼容主题开关、区域默认下行和部分格式说明，按各章当前规则处理。原 PDF 可下载参考，其中旧版界面和带注释/中文引号 JSON 不直接复制执行。