小鹰开放平台设备管理文档v1.1.15

2.1.12、固件OTA升级（仅开放平台新架构固件支持）

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

请求数据

字段名	类型	是否必填	备注
device_id	string	是	设备id
timestamp	int64	是	时间戳，单位：秒
nonce	string	是	随机字符串
sign	string	是	签名
imei	string	否	设备IMEI，可传空字符串
data	string	否	自定义data，可传空字符串
password	string	否	设备密码，如果不传则使用开放平台中注册设备的密码
upgrade_host	string	是	升级服务器地址
upgrade_file	string	是	升级包名，需要包含 '/'
upgrade_version	string	否	设备版本号(可不传，会自动从upgrade_file中解析)
upgrade_force	int	是	校验版本 0->自动校验 1->不校验

请求示例

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请求示例

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
}'

返回数据

字段名	类型	备注
error_code	int	状态码：0正常，其他异常
error_message	string	错误信息：正常为success

示例：

JSON

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