获取设备本地录像文件列表
接口调用说明
请求地址 : /v1/api/device/record/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:升序 默认为:asc |
提示:国标及国标下级平台设备不支持分页及排序,且仅允许最大查询时间间隔为24小时
//示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : 0,//视频通道号
"startTime":"20200914000000",
"endTime":"20200914235959",
"pageStart":1,
"pageSize":10
"sortByTime":asc
}
响应报文
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
code | int | 是 | 状态码 |
msg | String | 是 | 状态码解释信息 |
data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
page | object | 是 | 分页信息 |
items | object[] | 是 | 设备录像列表信息 |
page内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
total | int | 是 | 总行数 |
curPage | int | 是 | 当前页数 |
size | int | 是 | 页大小 |
items内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
fileName | String | 是 | 文件名称 |
startTime | String | 是 | 开始时间(格式:yyyyMMddHHmmss) |
endTime | String | 是 | 结束时间(格式:yyyyMMddHHmmss) |
recordType | String | 是 | 文件类型,alarm-报警录像,normal-普通录像 |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"page": {
"total": 3,
"curPage": 1,
"size": 10
},
"items": [{
"fileName": "00/N01092926",
"startTime": "20200914092926",
"endTime": "20200914092942",
"recordType": "alarm"
}, {
"fileName": "00/N01103004",
"startTime": "20200914103004",
"endTime": "20200914104006",
"recordType": "normal"
}, {
"fileName": "00/N01104007",
"startTime": "20200914104007",
"endTime": "20200914105008",
"recordType": "normal"
}]
}
}
错误码
状态码 | 状态描述 |
---|---|
1000 | 成功 |
1001 | 参数错误 |
1002 | 请求异常 |
1006 | AccessToken异常 |
2002 | 设备不在线 |
2006 | 设备能力不支持 |
2008 | 设备不存在 |
2009 | 视频通道号不合法 |