PRODUCT & TECHNOLOGY对接业务系统的基本路径 · 流程示意
开放API与设备集成
让状态、事件和处理结果进入客户已有的平台与设备流程。
当前对外接口目录
以下按仓库对外接口规范V2整理，可用于技术评估。接口实际可用性以安装版本、配置和联调结果为准。
| 方法 | 接口 | 用途 |
|---|---|---|
| GET | /api/integration/v2/device | 读取盒子状态 |
| GET | /api/integration/v2/cameras | 读取摄像头状态 |
| GET | /api/integration/v2/capabilities | 读取开放能力 |
| GET | /api/integration/v2/alarms | 游标补查告警 |
| GET | /api/integration/v2/alarms/{event_id} | 读取告警详情 |
| GET | /api/integration/v2/alarms/{event_id}/snapshot | 读取告警截图 |
| POST | /api/integration/v2/alarms/{event_id}/ack | 确认告警 |
事件推送与工业接口
| 方式 | 用途 | 集成重点 |
|---|---|---|
| HTTP Webhook | 推送告警生命周期与媒体就绪事件 | 验证签名、以投递ID去重并处理重试 |
| MQTT | 将事件接入消息平台 | 主题、认证、TLS与重复消息处理 |
| Modbus读取 | 读取设备在线、摄像头和未确认告警状态 | 只读寄存器，不等同于任意远程控制 |
当前V2规范明确不提供事件视频接口；截图与事件视频是不同资源。截图可按接口约定获取，临时媒体链接有有效期。
先联调一条完整事件
使用测试设备验证认证、状态读取、真实事件、截图获取和确认处理。区分“请求已接受”和“业务处理完成”，对重复投递、断网补查与失败响应分别处理。
下载对外接口规范 V2（JSON） ↓
技术规范文件，不含设备地址、账号或实际密钥。