Eye4Cloud Open Platform Device Management Documentationv1.1.15

2.1.12 Firmware OTA Upgrade (supported only by the new Open Platform firmware)

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/firmwareOta

Request Data

Field Name	Type	Required	Description
device_id	string	Yes	Device ID
timestamp	int64	Yes	Timestamp in seconds
nonce	string	Yes	Random String
sign	string	Yes	Signature
imei	string	No	Device IMEI; an empty string can be passed
data	string	No	Custom data; an empty string can be passed
password	string	No	Device password; if omitted, the password registered for the device on the Open Platform is used
upgrade_host	string	Yes	Upgrade Server URL
upgrade_file	string	Yes	Upgrade package name; must contain '/'
upgrade_version	string	No	Device version (optional; automatically parsed from upgrade_file)
upgrade_force	int	Yes	Version check: 0=automatic validation; 1=skip validation

Request Example

JSON

{
    "device_id": "xxx",
    "timestamp": 1755685731,
    "nonce": "dask43hfad",
    "sign": "xxxxxxx",
    "upgrade_host": "https://example.com/DEMO_RESOURCE",
    "upgrade_file": "/firmware_VP_OTA_22.212.109.7_20260520_160203_1779516167.bin",
    "upgrade_version": "1.0.0",
    "upgrade_force": 0
}

CURL Request Example

CURL

curl 'https://open.eye4cloud.com/xxxxx/open/v1/device/firmwareOta' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxx",
    "timestamp": 1757472185,
    "nonce": "",
    "sign": "",
    "upgrade_host": "https://example.com/DEMO_RESOURCE",
    "upgrade_file": "/firmware_VP_OTA_22.212.109.7_20260520_160203_1779516167.bin",
    "upgrade_version": "22.212.109.7",
    "upgrade_force": 0
}'

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

Example:

JSON

{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {}
}