# 【旧】查询通道的云端录像回放地址 #### 功能介绍 查询通道的云端录像回放地址 **备注：** 播放云端录像回放需要将[表4]中的playback_url输入到播放地址栏 #### URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records/playback-url 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_id | 是 | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215)章节 | | device_id | 是 | String | 设备ID： 好望设备：大小写字母、数字组成，长度范围\[8,32\]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 | | channel_id | 是 | String | 通道ID： 好望设备：取值范围\[0,999\] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | playback_protocol | 是 | String | 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型 枚举值： - **HOLO** 好望协议 - **HLS** 基于HTTP的HLS流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） - **HLS_HTTPS** 基于HTTPS的HLS流媒体传输协议 - **RTSP** RTSP流媒体传输协议（该协议存在安全风险，建议优先使用其他协议） | | record_type | 否 | String | 录像类型：枚举类型，不填则默认包含以下两种录像类型 枚举值： - **NORMAL_RECORD** 全量录像 - **MOTION_RECORD** 动检录像 | | start_time | 是 | String | 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 | | end_time | 是 | String | 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 | | expire_time | 否 | String | 自定义Url过期时间：时间范围\[30, 86400\]，不填写时默认值为 30（单位/秒） **备注：仅对channels中的live_url有效** | | use_times | 否 | String | 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0，RTSP协议固定为 0 **备注：仅对channels中的live_url有效** 枚举值： - **0** 使用一次 - **1**有效时间内任意使用，此参数对RTSP协议无效 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Access-Token | 是 | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | device_id | String | 设备ID：设备唯一标识，长度范围\[1,32\] | | channel_id | String | 通道ID：长度范围\[1,20\] | | playback_url | String | 录像回放地址：将此url输入播放地址栏开始播放 | #### 请求示例 查询云端的录像回放地址 ``` GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HOLO GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HLS GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records/playback-url?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&playback_protocol=HLS_HTTPS ``` #### 响应示例 **状态码： 200** OK ``` { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "holo://123.123.*.*:***/vod/952352LWXT***?token=..." } { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "http://123.123.*.*:***/vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0" } { "device_id" : "952352LWXT***", "channel_id" : "0", "playback_url" : "https://123.123.*.*:***/vod/vod.m3u8?token=...&device_id=952352LWXT***&channel_id=0" } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)