HTTP POST 数据转发

HTTP POST 转发将一批新数据作为 JSON 数组发送到 Webhook 地址。接收端需要接受 POST、解析整个数组，并校验已配置的认证信息。

配置连接

管理员或所有者进入组织 → 数据 → 数据分发，点击新建配置，选择 HTTP Post，填写目标地址及密钥，启用并保存。

字段	填写内容
URL	接收端可从云端访问的 HTTP 或 HTTPS 地址；正式接入使用 HTTPS
密钥	接收端约定的 Bearer 认证值，可留空
配置名称	用来区分不同接收系统
优先级	数值越大越先执行，不改变数据的采集时间

设置密钥后，请求头包含：

Content-Type: application/json
Authorization: Bearer <YOUR_SECRET>

请求体

消息是数组，一个请求可以包含多个点位或多个时刻的记录。常见数据结构示例：

[
  {
    "agri_id": "POINT_AGRI_ID",
    "t": 1709856000,
    "value": 25.3,
    "org_slug": "your-org-slug"
  }
]

agri_id 标识点位，t 表示时间，value 为点位值。上报记录还可能带有类型、项目等字段，旧数据链路可能使用 org_id 表示组织。接收程序应保留需要的原始字段，并用实际收到的首批消息核对字段和时间单位。

验证接收

1. 让设备上报一条新数据，观察接收端请求日志。
2. 核对点位、时间和值，检查是否处理了数组中的每条记录。
3. 接收端成功处理后返回 200、201 或 202；当前发送端将这三个状态计为成功，204 不在其中。
4. 在分发列表查看数量，再检查接收系统是否已保存数据。

需要先测试消息格式时，可使用页面提供的测试 URL 及测试数据查看入口。测试记录用于短期检查，不应作为历史数据存储。

没有收到请求

检查配置是否启用、URL 是否可从云端访问、HTTPS 证书及认证是否正确。内网地址和 localhost 不能直接作为云端可访问的接收地址。

不要把 HTTP 成功状态直接当成下游业务处理完成。接收系统若异步入库，还应检查自己的队列和保存结果。

通用启停及密钥修改规则见数据转发配置。