调用该接口获取当前用户名下的待升级或待确认设备的列表。

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

请求参数

名称 类型 是否必选 示例值 描述
groupId String 空间的ID。生活物联网平台赋予空间的唯一标识符。

返回数据

名称 类型 示例值 描述
data JSON

当前用户名下的待升级或待确认的设备列表。

iotId String

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

image String

设备对应的品类图标,当云端系统配置了设备所属产品的品类图标时有效。

deviceName String

设备显示名称,会优先使用用户配置的设备昵称返回,如果不存在昵称的配置则返回对应的产品名称。

示例

请求示例

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

正常返回示例

JSON 格式

{
    "id": "94e0871c-0770-xxxx-xxxx-e840d86b3ba6",
    "code": 200,
    "data": [
        {
           "iotId": "xxxx",
           "image": "xxxx",
           "deviceName": "xxxxxx"
        },
        {
           "iotId": "xxxx",
           "image": "xxxx",
           "deviceName": "xxxxxx"
        }
    ]
}

异常返回示例

JSON 格式

{}