获取设备上的固件是否有可用升级

更新时间：2023-07-06 07:34:04下载pdf

本文介绍获取设备上的固件是否有可用升级的 API。

接口描述

获取设备上的固件是否有可用升级

接口地址

GET: /v1.0/iot-03/devices/{device_id}/upgrade-infos

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID

返回参数

参数名	类型	说明
result	List

result 说明

参数名	类型	说明
upgrade_status	Integer	有新版本可升级的通道upgradeStatus=1; 否则为0；如果设备正在升级中，对应status=2
current_version	String	设备该通道固件当前版本号
upgrade_version	String	设备该通道固件要 OTA 的版本号
upgrade_desc	String	升级描述信息
upgrade_type	Integer	升级方式
module_type	Integer	固件对应通道号，确认升级时要指定该通道号
module_desc	String	模块类型描述
last_upgrade_time	Long	上次升级时间
control_type	Integer	设备是否可控
url	String	有关文件的相关字段，主要用于蓝牙等设备

请求示例

GET: /v1.0/iot-03/devices/002000425ccf7fc7342a/upgrade-infos

返回示例

[
    {
        "module_desc": "{\"code\":\"FIRMWARE_UPGRADE_TYPE_DESC_0\"}",
        "module_type": 0,
        "current_version": "1.1.5",
        "upgrade_status": 0,
        "last_upgrade_time": 0,
        "control_type": 0
    },
    {
        "module_desc": "{\"code\":\"FIRMWARE_UPGRADE_TYPE_DESC_9\"}",
        "module_type": 9,
        "current_version": "1.0.0",
        "upgrade_status": 0,
        "last_upgrade_time": 0,
        "control_type": 0
    }
]

错误码

参考错误码。