2.10、Get Recording File List

Get Device Recording File List

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/getRecordFile
Request Data
Field Name Required Type Description
device_id Yes string Device ID
timestamp Yes int64 Timestamp in seconds
nonce Yes string Random string, 8-20 characters
sign Yes string See "Sign Generation Examples" for the implementation details
password No string Device password; if omitted, the password registered for the device on the Open Platform is used
folder_name Yes string Get the Directory Name Returned by the Recording API
start_time No string Start time, format: "08:00:00"
end_time No string End time, format: "14:00:00"
data No string Device DATA; an empty string can be passed
imei No string Device IMEI; an empty string can be passed
CURL Request Example
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"
}'
Response Data
Field Name Type Description
error_code int Status code: 0 indicates success; other values indicate an error
error_message string Error message; success indicates a normal response
data object {}
data.list array Recording file list()
data.list.record_name string Recording file name (YYYYMMDDHHmmss_identifier.mp4); each file is five minutes long
data.list.record_size string File Size

Example:

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"}
      ]
    }
}