新旧版本使用指引
最近更新时间:2025-11-21 07:44:44
智能视图服务全新版本已正式上线,与旧版API相比,新版API提供更加规范和丰富的能力接口,提升用户的开发体验。
说明:旧版API后续将不再维护并逐步下线,为了您有更好的使用体验,请尽快迁移至新版本。
1. 如何区分新版还是旧版
1.1. 控制台区分
用户可以登录控制台,通过左侧菜单栏快速确认当前用户版本。
旧版:旧版通过不同协议的业务组对设备进行管理,左侧菜单栏有【业务组管理】功能模块。
新版:新版的左侧菜单栏不再有【业务组管理】功能模块,用户可使用全新的【设备管理】模块统一管理不同协议接入的设备。
1.2. API区分
用户可以从API的调用方式、请求参数确认当前正在使用的API版本,下面以查询视频流URL为例。对于升级的用户,旧版AKSK可以在新版API复用。
旧版:
- 请求结构:旧版API均为GET请求,通过Query参数中的Action区分不同API。
- 签名方式:旧版API通过对请求参数排序并拼接请求字符串,使用HMAC-SHA1算法生成签名,详细内容可参考签名方法。
新版
- 请求结构:新版API采用RESTful形式,支持POST/PUT/GET/DELETE请求方法,通过URI区分不同API。
- 签名方式:新版API通过拼接规范请求串,使用HMAC-SHA256算法生成签名后按格式拼接Authorization,详细内容可参考签名方法。
2. 新版与旧版API对应关系说明
您可参考以下新旧版本API对应关系,使用新版API替换旧版API。除以下清单外,新版API还提供视图设备接入/存储/查询、回调模板/规则配置等更多接口,并持续更新中。
| 功能 | 旧版API | 新版API |
|---|---|---|
| 组管理 | 创建组 | 新版不再通过业务组的方式分别管理不同协议的设备,支持多协议混合管理,用户可直接创建设备。 |
| 查询组列表 | ||
| 目录管理 | 查询目录 | 查询目录 |
| 查询目录列表 | 查询目录列表 | |
| 设备管理 | 创建设备 | 创建设备 |
| 删除设备 | 删除设备 | |
| 修改设备 | 修改设备 | |
| 启动设备拉流 | 启用流 | |
| 停止设备拉流 | 停用流 | |
| 查询设备 | 查询设备 | |
| 查询设备列表 | 查询设备列表 | |
| 查询设备通道列表 | 查询设备列表 | |
| 查询本地录像文件列表 | 查询录像列表 | |
| 云台控制 | 开始镜头转动 | 开始镜头转动 |
| 停止镜头转动 | 停止镜头转动 | |
| 开始镜头调节 | 开始镜头调节 | |
| 停止镜头调节 | 停止镜头调节 | |
| 查询预置位列表 | 查询预置位列表 | |
| 流管理 | 查询视频流URL | 查询设备云端直播流 |
| 录制管理 | 创建录制模板 | 创建存储模板 |
| 创建录制规则 | 绑定存储模板 | |
| 查询录制文件 | 即将上线 | |
| 查询录制文件列表 | 查询录像列表 | |
| AI管理 | AI应用基于设备停止 | 即将上线 |
| 实时告警信息查询 | ||
| AI分析结果告警查询 | ||
| 资源包管理 | 根据设备查询绑定资源包列表 | 查询设备资源列表 |
| 查询资源包列表 | 查询用户资源列表 | |
| 无 | 查询资源的设备列表 | |
| 更新设备资源 |
本页目录: