获取录像文件列表 | 小鹰云开放平台文档

2.10、获取录像文件列表

获取设备录像文件列表

POSThttps://open.eye4cloud.com/{{open_id}}/open/v1/device/getRecordFile

请求数据

字段名	是否必传	类型	备注
device_id	是	string	设备id
timestamp	是	int64	时间戳，单位：秒
nonce	是	string	随机字符串，8~20个字符
sign	是	string	具体实现方法，请参考《生成sign的示例代码》
password	否	string	设备密码，如果不传则使用开放平台中注册设备的密码
folder_name	是	string	获取录像接口返回的目录名称
start_time	否	string	开始时间，格式："08:00:00"
end_time	否	string	结束时间，格式："14:00:00"
data	否	string	设备DATA，可传空字符串
imei	否	string	设备IMEI，可传空字符串

CURL请求示例

CURL

curl 'https://open.eye4cloud.com/{{open_id}}/open/v1/device/getRecordFile' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxxx",
    "timestamp": 1758867195,
    "nonce": "",
    "sign": "",
    "folder_name": "20251226"
}'

返回数据

字段名	类型	备注
error_code	int	状态码：0正常，其他异常
error_message	string	错误信息：正常为success
data	object	{}
data.list	array	录像文件列表()
data.list.record_name	string	录像文件名(年月日时分秒_标识.mp4)，每个文件5分钟
data.list.record_size	string	文件大小

示例：

JSON

{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
      "list":[
        {"record_name":"20251227111833_100.mp4","record_size":"10128391"},
        {"record_name":"20251227112334_100.mp4","record_size":"10128391"},
        {"record_name":"20251227112834_100.mp4","record_size":"10128391"}
      ]
    }
}