获取当前用户名下的待升级（待确认）的设备列表。

路径 /living/ota/devices/list
版本号 1.0.0
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 25000

请求参数

返回数据

名称类型示例值描述
名称 类型 示例值 描述
code Int

接口返回码。200表示成功。
message String

调用失败时，返回的出错信息。
localizedMsg String

本地语言的错误消息。
data JSON

调用成功时，返回待升级的设备基本信息列表。
iotId String

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

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

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

设备的联网方式，可取值： NET_LORA（表示LoRa）；NET_CELLULAR（表示2G/3G/4G/5G蜂窝网）；NET_WIFI（表示Wi-Fi）；NET_ZIGBEE（表示ZigBee）；NET_ETHERNET（表示以太网）；NET_OTHER（表示其他网络类型）。
deviceStatus Int

设备状态，可取值：0（未激活）；1（在线）；3（离线）；8（禁用）。

示例

请求示例

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

正常返回示例

JSON 格式 

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data": [
        {
           "iotId": "xxxx",
           "deviceIcon": "xxxx",
           "deviceName": "xxxxxx",
           "deviceNetType": "NET_WIFI",
           "deviceStatus": 1
        },
        {
           "iotId": "xxxx",
           "deviceIcon": "xxxx",
           "deviceName": "xxxxxx",
           "deviceNetType": "NET_WIFI",
           "deviceStatus": 3
        }
    ]
}

异常返回示例

JSON 格式 

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}