Get album file list

1. API Description

This API is used to get the album file list, including recorded videos and screenshots.

Request mode:

  • V2.6.0 and above: POST [ip]/mwapi/V2.0/album/get-album-files-list
  • V2.5.0 and below: POST [ip]/mwapi/get-album-files-list
Administrator Rights Logged-in
No Yes

2. Input Parameters

Name Required Type Description
type Yes Int Resource type
0: All the files
1: Screenshot
2: Recorded video

3. Output Parameters

Name Type Description
result Int Status code
message String Status description
info InfoData Info objects
InfoData
Name Type Description
items Array of MediaData Array of media data
pageIndex Int Page index
totalCount Int Total counts of media data
MediaData
Name Type Description
id Int The file ID
type Int The file type
1: Screenshot
2: Recorded video
name String The resource name
md5 String The MD5 value of the file
filePath String The relative path of the file, accessible via http://device IP/relative path.
thumbPath String The relative path of the thumbnail, accessible via http://device IP/relative path.
createTime Int The file creation time, represented as a timestamp relative to 1970-01-01.
duration Int The duration of the file. Only valid for videos, in ms.
size Int The file size, in Byte.

4. Example

Getting the screenshot list.

Input Example
{
    "type":1
}
Output Example
{
    "info": {
        "items": [
            {
                "createTime": 1640055676,
                "duration": 0,
                "filePath": "album/2a83adf5-3e0d-4ad0-9af5-81d8fc0fea18.jpeg",
                "id": 2,
                "md5": "md5",
                "name": "2021.12.21 11:01AM",
                "size": 502784,
                "thumbPath": "album/2a83adf5-3e0d-4ad0-9af5-81d8fc0fea18.thumb.jpeg",
                "type": 1
            },
            {
                "createTime": 1640055673,
                "duration": 1849,
                "filePath": "album/16241d75-12ea-4344-bf7f-bf683e9b850e.mp4",
                "id": 1,
                "md5": "md5",
                "name": "2021.12.21 11:01AM",
                "size": 1487872,
                "thumbPath": "album/16241d75-12ea-4344-bf7f-bf683e9b850e.thumb.jpeg",
                "type": 2
            }
        ],
        "pageIndex": 0,
        "totalCount": 2
    },
    "message": "success",
    "result": 0
}

5. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Status Definition Description
7 MW_STATUS_INVALID_ARG Missing required parameters

results matching ""

    No results matching ""