Edge HTTP 上行推送

此接口是 网关作为客户端向应用服务器 POST，不是外部程序向网关轮询，也不提供 1.0.6 文档中的 HTTP 业务下行。下行使用 MQTT，或在可达且经过认证时使用管理 API。

操作视频

G4 Edge 实机：填写 HTTP URL / 请求头、测试、保存和核对 POST · 下载视频

展示 HTTP 入口、URL 和请求头、空对象测试、保存重连以及接收端正式上行。步骤6使用本次保存后的真实参数回读截图，方便核对 URL 和请求头。空测试体和真实终端业务分开计数。本次未验证生产 HTTPS、认证、持久化重发或外设测量。

接收端先准备

提供网关能访问的 URL，例如 https://receiver.example.com/uplink，支持 POST、JSON 请求体，并在成功处理后返回 2xx。需要认证时，在网关 HTTP 配置添加请求头，例如 Authorization；密钥不放截图或示例文件。

网关配置步骤

1. 确认处于 Edge，进入网关配置的输出配置，勾选 HTTP。
2. 填完整接收 URL，包含协议、路径及需要的查询参数。
3. 按需添加请求头，核对名称和值，避免空行或重复认证。
4. 现场允许时测试，确认后保存并等待重启。
5. 用真实终端上行检查接收端请求日志、FPort 和载荷。

测试会发送 {} 的实际 POST，不是真实终端数据。当前配套实现的 HTTP 测试与正式推送均跳过 HTTPS 服务端证书校验，测试成功不能证明证书有效或服务器身份已验证。接收端不能因为缺少 app 字段就把全部测试视为网络不通；也不能把测试成功当作业务解析成功。

格式与单位

默认请求体为 MQTT 原生上行 JSON，载荷同样经过当前版本的旧帧兼容处理，Content-Type 为 application/json。需要兼容应用 JSON 时，在 URL 上带 compatOpen=true：

https://receiver.example.com/uplink?compatOpen=true
https://receiver.example.com/uplink?site=demo&compatOpen=true

已有查询参数时用 &，不是再加一个 ?。兼容输出用 data Base64 和 txInfo.frequency Hz，原生输出用 payload Base64 和 motetx.freq MHz。

失败处理

当前 HTTP 请求超时约 5 秒，以最终响应是否为 2xx 判断成功，响应体不作为业务确认结果解析；默认 HTTP 客户端可能跟随重定向，接收地址应直接使用最终业务 URL。接收端尽快确认接收，将耗时业务转入自己的处理队列；网关没有在本册承诺 HTTP 失败后的持久化重发，不依赖它实现“恰好一次”。检查网络、DNS、URL 路径、认证、响应码和接收日志，再核对终端真实数据。

对照界面填写与核对

Edge HTTP 配置（界面示例）：URL 在左侧，右侧加号新增请求头，减号删除所在行。图中 X-Site: demo 为教学请求头，未测试或保存。 点击放大

Edge HTTP 配置（界面示例）：URL 在左侧，右侧加号新增请求头，减号删除所在行。图中 X-Site: demo 为教学请求头，未测试或保存。

位置	填写内容	生效与结果
URL	完整 http:// 或 https:// 接收地址	必须从网关所在网络可达；电脑上可用不代表网关可用
加号后的 Key / Value	如 X-Site / demo；认证按应用要求	同一个 Key 不要重复；空 Key/Value 行不作为有效请求头
HTTP 测试	向已授权的接收端发送 {}	接收端看到空对象测试，且返回 2xx；不期待传感器字段
保存	将完整配置写入并重启	重连后再用真实终端业务包核对

URL 中的 localhost / 127.0.0.1 指网关自己；接收程序运行在电脑上时，填写电脑可被网关访问的局域网 IP 和端口。接收端若返回 301/302、401、404 或 500，应先检查实际响应及路径/认证，不把错误页当业务确认。

正式验收应看到什么

接收端日志应记录来源、时间、请求路径、Content-Type、完整 JSON 和处理结果。检查 app.moteeui、app.userdata.port、app.userdata.payload；使用兼容格式时改查 devEUI、fPort、data。空对象仅是测试体，不加入传感器历史记录。可运行的接收端示例见本地 HTTP 接收。

G4 实机配置与接收

G4 Edge 保存重启后重新读取的 HTTP 配置：测试电脑地址、端口、接收路径和请求头分别核对。 点击放大

G4 Edge 保存重启后重新读取的 HTTP 配置：测试电脑地址、端口、接收路径和请求头分别核对。

测试电脑接收端的真实 HTTP POST 记录。空对象测试另行计数，正式上行显示终端 FPort、计数和原始字节。 点击放大

测试电脑接收端的真实 HTTP POST 记录。空对象测试另行计数，正式上行显示终端 FPort、计数和原始字节。

本次接收端实际收到标准 DTU 的 FPort 40 心跳，并与 MQTT 的同一上行逐项对应。测试服务使用局域网 HTTP，没有验证生产环境 HTTPS、认证或持久化重发。完整步骤见HTTP 配置实录。