调用该接口获取当前正在升级的设备列表信息。

路径 /thing/ota/upgrade/listByUser
版本号 1.0.2
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

返回数据

名称 类型 示例值 描述
data JSON

当前正在升级的设备信息列表。

iotId String

设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

step Int

升级进度或升级错误信息。负数时,表示升级错误信息: -1(表示升级操作失败);-2(表示固件文件下载失败);-3(表示固件文件校验失败);-4(表示固件文件烧写失败)。非负数时表示升级进度,单位:百分比。

desc String

描述信息。

success Boolean

是否成功标记。true(表示固件升级操作成功);false(表示升级未完成,包括正在升级或升级失败)。请优先选择upgradeStatus参数来判断固件升级状态。

needConfirm Boolean

是否需要用户进行确认操作。

upgradeStatus Int

当前升级状态。0(表示待升级或待确认);1(表示升级中);2(表示升级异常);3(表示升级失败);4(表示升级成功)。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2",
		"iotToken": "token"
	},
	"params":{}
}

正常返回示例

JSON 格式

{
    "id": "94e0871c-0770-xxxx-xxxx-e840d86b3ba6",
    "code": 200,
    "data": [
        {
            "iotId": "xxxx",
            "step": 10,
            "desc": "xxxxxx",
            "success": false,
            "needConfirm": true,
            "upgradeStatus": 0
        },
        {
            "iotId": "xxxx",
            "step": 10,
            "desc": "xxxxxx",
            "success": false,
            "needConfirm": true,
            "upgradeStatus": 0
        }
    ]
}

异常返回示例

JSON 格式

{}