playBackList

Singapore

https://mettahub.mettaxiot.com/gps

POST

/v2/openapi/video/history/list

fileUrl is empty, indicating that no historical videos have been uploaded. You can upload device history videos through "/v2/openapp/video/history/upload". You can view all upload records through "/v2/openapi/video/history/upload/task".

Request

Header Params

Authorization

string

required

Body Params application/json

deviceId

string | null

required

deviceId

channelId

integer | null

required

channelId

>= 1

startTime

string | null

required

startTime Device Time Zone yyyy-MM-dd HH:mm:ss

endTime

string | null

required

endTime Device Time Zone yyyy-MM-dd HH:mm:ss

Example

{
    "deviceId": "string",
    "channelId": 1,
    "startTime": "string",
    "endTime": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mettahub.mettaxiot.com/gps/v2/openapi/video/history/list' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deviceId": "string",
    "channelId": 1,
    "startTime": "string",
    "endTime": "string"
}'

Responses

🟢200Success

application/json

Body

code

integer | null

optional

data

array[object (ApiVideoHistoryVO) {6}] | null

optional

deviceName

string | null

optional

deviceName

channelId

integer | null

optional

channelId

fileSize

number | null

optional

fileSize unit(MB)

startTime

string | null

optional

startTime yyyy-MM-dd HH:mm:ss Device Time Zone

endTime

string | null

optional

endTime yyyy-MM-dd HH:mm:ss Device Time Zone

fileUrl

string | null

optional

file download path

msg

string | null

optional

Example

{
  "code": 0,
  "data": [
    {
      "deviceName": "",
      "channelId": 0,
      "fileSize": 0.0,
      "startTime": "",
      "endTime": "",
      "fileUrl": ""
    }
  ],
  "msg": ""
}

Modified at 2025-06-06 08:23:23

liveVideo

historicalUpload