获取设备云端录像文件列表
接口调用说明
请求地址 : /v1/api/device/cloudstorage/get_record_list
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| channelId | int | 是 | 视频通道号 |
| startTime | String | 是 | 开始时间(格式:yyyyMMddHHmmss) |
| endTime | String | 是 | 结束时间(格式:yyyyMMddHHmmss) |
| pageStart | int | 是 | 分页起始页(1开始) |
| pageSize | int | 是 | 分页大小(单页最大支持500) |
| sortByTime | string | 否 | 按时间排序,desc=降序,asc=升序,默认升序 |
//示例数据
{
"deviceSn" : "*",//设备序列号
"channelId" : 0,//视频通道号
"startTime":"20200914000000",
"endTime":"20200914235959",
"pageStart":1,
"pageSize":10
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| page | object | 是 | 分页信息 |
| items | object[] | 是 | 设备录像列表信息 |
page内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| total | int | 是 | 总行数 |
| curPage | int | 是 | 当前页数 |
| size | int | 是 | 页大小 |
items内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| recordId | String | 是 | 录像ID,作为 获取云存录像缩略图下载地址 请求报文中的【recordId】字段 |
| fileName | String | 是 | 文件名称 |
| startTime | String | 是 | 开始时间(格式:yyyyMMddHHmmss) |
| endTime | String | 是 | 结束时间(格式:yyyyMMddHHmmss) |
| recordType | String | 是 | 文件类型,alarm-报警录像,normal-普通录像 |
| thumbnailExists | Boolean | 是 | 缩略图是否存在 |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"page": {
"total": 93,
"curPage": 1,
"size": 10
},
"items": [{
"recordId": "************",
"fileName": "00/N01092926",
"startTime": "20200914092926",
"endTime": "20200914092942",
"recordType": "alarm",
"thumbnailExists": true
}, {
"recordId": "************",
"fileName": "00/N01103004",
"startTime": "20200914103004",
"endTime": "20200914104006",
"recordType": "normal",
"thumbnailExists": true
}, {
"recordId": "************",
"fileName": "00/N01104007",
"startTime": "20200914104007",
"endTime": "20200914105008",
"recordType": "normal",
"thumbnailExists": false
}]
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常或过期 |
| 2008 | 设备不存在 |
| 2009 | 视频通道号不合法 |