获取设备升级信息

更新时间:2024-06-28 21:41:34下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID。

返回参数

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

result 说明

参数名类型说明
successBoolean操作是否成功。
error_codeString错误码。
error_msgString错误信息。
resultList返回结果。

result 说明

参数名类型说明
upgrade_statusInteger升级状态。
  • 0:无升级
  • 1:设备准备就绪
  • 2:升级中
  • 3:升级完成
  • 4:升级异常
  • 7:升级超时
current_versionString设备该通道固件的当前版本号。
versionString设备该通道固件 OTA 升级的目标版本号。
descString升级描述信息。
upgrading_descString固件升级中的文案展示,多语言。
downloading_descString固件下载中的文案展示,多语言。目前,该字段只适用于 NB-IoT设备。
waiting_descString非保活设备固件升级过程中,等待设备唤醒时 app 显示文案。
dev_typeInteger设备类型。
  • 0:普通设备
  • 1:非保活设备
timeoutInteger升级超时时间。
upgrade_typeInteger升级方式。
typeInteger固件对应通道号。
type_descString模块类型描述。
urlString有关文件的 URL 字段,主要用于蓝牙等设备。
md5String升级包 MD5 值。
signString升级包签名。
file_sizeString文件大小。
last_upgrade_timeLong上次升级时间。
firmware_deploy_timeLong固件发布时间。
control_typeInteger设备升级过程中是否可控。
  • 0:不可控
  • 1:可控
can_upgradeBoolean设备是否满足 DP 条件可以升级。
  • 0:不可升级
  • 1:可以升级
remindString提示不可升级的原因,多语言支持。

请求示例

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
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制