获取设备本地录像下载地址,按时间段-标准协议
接口调用说明
请求地址 : /v1/api/device/video/get_download_standard_url_bytime
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| channelId | int | 是 | 视频通道号 |
| startTime | String | 是 | 起始时间段,yyyyMMddHHmmss |
| endTime | String | 是 | 结束时间段,yyyyMMddHHmmss |
| protocolType | String | 是 | 协议类型 wss |
| streamUUID | String | 否 | 流UUID(字母,数字,下划线),最长 42 位,可以为一个随机数,如果不传,后台会自动生成一个 |
//示例数据
{
"deviceSn":"12421SSxxxxx",
"channelId":0,
"startTime":"20200914000000",
"endTime":"20200914235959",
"protocolType":"wss",
"streamUUID":"1234567890956789uytrewqwerty23"
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| url | String | 是 | 下载地址URL,有效期180S,超时后无法下载,需要重新获取下载地址 |
| streamUUID | String | 是 | 流UUID |
//示例数据
{
"code":1000,
"msg":"OK",
"data":{
"url":"wss://xxx.xxx.xxx.xx:8080?token=xxxxxxxxxxxxxx.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx",
"streamUUID":"1234567890956789uytrewqwerty23"
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常 |
| 2002 | 设备不在线 |
| 2006 | 设备能力不支持 |
| 2008 | 设备不存在 |
| 2009 | 视频通道号不合法 |
| 4002 | 获取录像地址异常 |
| 4003 | 资源不存在 |