customHistoricalUpload

Singapore

https://mettahub.mettaxiot.com/gps

POST

/v2/openapi/video/custom/history/upload

1.The minimum interval for requests with the same parameters is 10 seconds. 2.The duration of a single uploaded file shall not exceed 10 minutes. 3.Please save the deviceId and uuid returned by this interface, as these parameters are required when canceling the upload. 4.Please listen for upload start, failure, and upload success events on your FTP server for file status management.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/json

Example

{
    "deviceId": "string",
    "channelId": 0,
    "startTime": "string",
    "endTime": "string",
    "ftpIp": "string",
    "ftpPort": 0,
    "ftpUserName": "string",
    "ftpPassword": "string",
    "ftpUploadFilePath": "string"
}

Request Code 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/custom/history/upload' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deviceId": "string",
    "channelId": 0,
    "startTime": "string",
    "endTime": "string",
    "ftpIp": "string",
    "ftpPort": 0,
    "ftpUserName": "string",
    "ftpPassword": "string",
    "ftpUploadFilePath": "string"
}'

Responses

🟢200

application/json

Body

Example

{
  "code": 0,
  "data": {
    "deviceId": "",
    "uuid": ""
  },
  "msg": ""
}

Modified at 2026-03-20 06:25:47

customHistoricalUploadStop

playBackList