HTTP 集成
功能路径:SVE 导航栏 → 结果集成 → HTTP
功能简介
智能相机将 AI 推理结果通过 REST API(POST) 方式上报到 HTTP 服务器。相机以 JSON 形式上报结果消息(含图片链接 originImg / finalImg / maskImg),服务器按约定接收并保存归档。
集成要求
| 项 | 要求 |
|---|---|
| HTTP 服务器 | 可被相机访问(同网段),已部署标准 HTTP 服务,提供接收上报的接口 |
| 请求方法 | POST(相机固定) |
| Content-Type | application/json(相机固定) |
| 请求路径 | http://<服务器IP>:<端口>/<接口路径> |
| 数据内容 | JSON:{"appId","appVersion","cameraId","timestamp","originImg","maskImg","finalImg","additional"} |
SVE 上基本配置
- 进入 结果集成 → HTTP;
- 打开 HTTP集成 开关;
- 填 REST API:
<服务器IP>:<端口>/<接口路径>;
注意:SVE 界面中「REST API」输入框已自带
http://前缀,只需填入 IP、端口和接口路径,无需再补写http://。
- 请求方法 = POST(固定,不可修改);Content-Type =
application/json(固定,不可修改); - 点击 保存。
基本验证
页面联调(测试发送)
- 配置完成后点击 测试发送;
- 观察右侧「联调请求」区域,显示 HTTP 200 响应即链路正常。
真实任务验证
- 在 任务管理 → AI 应用 中对该应用触发「运行预览」,让相机完成一次推理;
- 在 HTTP 服务器/接收端确认收到相机上报的请求:内容为完整 JSON(含
appId/timestamp/originImg等图片链接)→ 集成成功。
常见问题
| 现象 | 排查 |
|---|---|
| 相机上报失败 | 检查端口/IP 是否可达;服务器接口是否运行(监听端口) |
| 接收端报格式错误 | 确认接收端按 application/json 解析;请求路径与服务器接口一致 |
| 未收到上报 | 确认 HTTP集成 开关已打开并已保存;触发过推理;REST API 已正确填写 IP/端口/接口路径 |