新旧版本使用指引

最近更新时间: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算法生成签名,详细内容可参考签名方法
旧版查询视频流URL接口

新版

  • 请求结构:新版API采用RESTful形式,支持POST/PUT/GET/DELETE请求方法,通过URI区分不同API。
  • 签名方式:新版API通过拼接规范请求串,使用HMAC-SHA256算法生成签名后按格式拼接Authorization,详细内容可参考签名方法
新版查询设备云端直播流接口

2. 新版与旧版API对应关系说明

您可参考以下新旧版本API对应关系,使用新版API替换旧版API。除以下清单外,新版API还提供视图设备接入/存储/查询、回调模板/规则配置等更多接口,并持续更新中。

功能 旧版API 新版API
组管理 创建组 新版不再通过业务组的方式分别管理不同协议的设备,支持多协议混合管理,用户可直接创建设备。
查询组列表
目录管理 查询目录 查询目录
查询目录列表 查询目录列表
设备管理 创建设备 创建设备
删除设备 删除设备
修改设备 修改设备
启动设备拉流 启用流
停止设备拉流 停用流
查询设备 查询设备
查询设备列表 查询设备列表
查询设备通道列表 查询设备列表
查询本地录像文件列表 查询录像列表
云台控制 开始镜头转动 开始镜头转动
停止镜头转动 停止镜头转动
开始镜头调节 开始镜头调节
停止镜头调节 停止镜头调节
查询预置位列表 查询预置位列表
流管理 查询视频流URL 查询设备云端直播流
录制管理 创建录制模板 创建存储模板
创建录制规则 绑定存储模板
查询录制文件 即将上线
查询录制文件列表 查询录像列表
AI管理 AI应用基于设备停止 即将上线
实时告警信息查询
AI分析结果告警查询
资源包管理 根据设备查询绑定资源包列表 查询设备资源列表
查询资源包列表 查询用户资源列表
查询资源的设备列表
更新设备资源