获取设备升级信息

更新时间：2023-11-23 06:28:46下载pdf

本文介绍获取设备升级信息的 API。

接口描述

根据设备 ID，获取设备升级信息。

接口地址

GET: /v2.0/cloud/thing/{device_id}/firmware

请求参数

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

返回参数

参数名	类型	说明
result	FusionResult	返回结果。

result 说明

参数名	类型	说明
success	Boolean	操作是否成功。
error_code	String	错误码。
error_msg	String	错误信息。
result	List	返回结果。

result 说明

参数名	类型	说明
upgrade_status	Integer	升级状态。 `0`：无升级 `1`：设备准备就绪 `2`：升级中 `3`：升级完成 `4`：升级异常 `7`：升级超时
current_version	String	设备该通道固件的当前版本号。
version	String	设备该通道固件 OTA 升级的目标版本号。
desc	String	升级描述信息。
upgrading_desc	String	固件升级中的文案展示，多语言。
downloading_desc	String	固件下载中的文案展示，多语言。目前，该字段只适用于 NB-IoT 设备。
waiting_desc	String	非保活设备固件升级过程中，等待设备唤醒时 app 显示文案。
dev_type	Integer	设备类型。 `0`：普通设备 `1`：非保活设备
timeout	Integer	升级超时时间。
upgrade_type	Integer	升级方式。
type	Integer	固件对应通道号。
type_desc	String	模块类型描述。
url	String	有关文件的 URL 字段，主要用于蓝牙等设备。
md5	String	升级包 MD5 值。
sign	String	升级包签名。
file_size	String	文件大小。
last_upgrade_time	Long	上次升级时间。
firmware_deploy_time	Long	固件发布时间。
control_type	Integer	设备升级过程中是否可控。 `0`：不可控 `1`：可控
can_upgrade	Boolean	设备是否满足 DP 条件可以升级。 `0`：不可升级 `1`：可以升级
remind	String	提示不可升级的原因，多语言支持。

请求示例

GET: /v2.0/cloud/thing/vdev1243432***/firmware

返回示例

{
    "result": {
        "channel": 0,
        "current_version": "1.0.0",
        "version": "2.0.0",
        "upgrade_type": 1,
        "timeout": 60,
        "upgrade_status": 1,
        "type_desc": "蓝牙",
        "desc": "固件升级",
        "control_type": 0
    },
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。