Appearance
轮询获取历史视频列表
接口说明
根据指令id获取历史视频列表,发送指令后,根据指令轮询这个接口,预计最多10s会返回历史视频列表。
请求URL
GET /route/rest
本接口通用参数里面method的值为jimi.open.video.getHistoryVideoListRoundRobin
HTTP请求方式
GET
请求参数
| 参数名 | 位置 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| app_key | query | String | 是 | 分配给应用的appKey |
| timestamp | query | String | 是 | 时间戳 |
| sign_method | query | String | 是 | 签名方法 |
| v | query | String | 是 | 版本号 |
| format | query | String | 是 | 格式 |
| access_token | query | String | 是 | 授权的令牌 |
| imei | query | String | 是 | 设备imei号 |
| method | query | String | 是 | jimi.open.video.getHistoryVideoListRoundRobin |
| instruction_id | query | String | 是 | 下发指令获取列表传唯一指令id |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 成功返回 -1: 失败 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 返回的数据 |
| data | Array | 历史视频列表 |
data数组中单个对象参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| channel | String | 摄像头通道 |
| fileSize | Long | 文件大小(字节) |
| beginTime | String | 视频开始时间 |
| endTime | Integer | 视频结束时间 |
返回示例
正确返回示例(200 OK):
plaintext
{
"code": 0,
"message": null,
"result": null,
"data": [
{
"channel": "1",
"beginTime": "2024-10-12 00:04:03",
"endTime": "2024-10-12 00:07:03",
"alarmFlag": 0,
"resourceType": 0,
"codeType": 1,
"storageType": 1,
"fileSize": 95226191,
"sortBeginTime": 1728662643000
}
]
}失败返回示例:
plaintext
{
"code": -1,
"message": "设备离线或不存在该时间段的视频"
}注意事项
- 时间范围不能超过24小时
- 系统只保留近30天的历史视频
- 视频URL带有时间戳和密钥,仅在返回时有效