版本记录
1.0.0
首个对外契约版本。当前已发布 71 个操作,按五类能力组织:
- 设备管理:设备与通道列表、详情、实时状态,设备告警记录与状态事件,维护操作记录查询,固件升级历史与结果,设备录像检索。
- 设备控制:通道状态与可控制能力、存储卡状态,实时点播;云台方向控制、精准定位、扫描与巡航、雨刷、看守位、目标跟踪、预置位与巡航轨迹;录像启停、报警布撤防与复位、设备重启、存储卡格式化、固件升级;设备录像回放会话。
- 设备配置:设备配置快照读取与下发(基础参数、录像计划、报警录像、图像遮挡、画面镜像、OSD、报警上报)、视频参数读写、配置操作状态查询。
- 设备媒体:语音对讲与语音广播会话、设备录像下载会话。
- 设备事件与位置:事件订阅、续订、取消与事件续读,设备最新位置与历史轨迹。
同时定义了 HMAC-SHA256 签名规范(11 行规范请求、300 秒时间戳偏差、Nonce 唯一性保留 660 秒)、 能力授权(Scope)、部门数据范围、限流、观看配额与幂等键约定。
版本号描述对外契约,不等同于 UVP 服务端内部版本号。破坏性修改必须发布新的 OpenAPI 主版本路径。