Skip to content

轮询获取历史视频列表

接口说明

根据指令id获取历史视频列表,发送指令后,根据指令轮询这个接口,预计最多10s会返回历史视频列表。

请求URL

GET /route/rest

本接口通用参数里面method的值为jimi.open.video.getHistoryVideoListRoundRobin

HTTP请求方式

GET

请求参数

参数名位置参数类型是否必须说明
app_keyqueryString分配给应用的appKey
timestampqueryString时间戳
sign_methodqueryString签名方法
vqueryString版本号
formatqueryString格式
access_tokenqueryString授权的令牌
imeiqueryString设备imei号
methodqueryStringjimi.open.video.getHistoryVideoListRoundRobin
instruction_idqueryString下发指令获取列表传唯一指令id

返回值

参数类型描述
codeInt返回码:
0: 成功返回
-1: 失败
messageString如果code不为0,会有相应的错误信息提示
resultString返回的数据
dataArray历史视频列表

data数组中单个对象参数列表:

参数类型描述
channelString摄像头通道
fileSizeLong文件大小(字节)
beginTimeString视频开始时间
endTimeInteger视频结束时间

返回示例

正确返回示例(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带有时间戳和密钥,仅在返回时有效