获取设备云端录像文件列表
接口调用说明
请求地址 : /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 | 视频通道号不合法 |