调用该接口获取家下的设备列表，支持多维度检索。

路径 /living/home/device/query
版本号 1.0.2
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 5000

请求参数

名称类型是否必选示例值描述
名称 类型 是否必选 示例值 描述
deviceNodeType String 否 GATEWAY, DEVICE 设备节点类型。DEVICE（设备），GATEWAY（网关）。
productKey String 否 a1U2****UZI 产品的Key，设备证书信息之一。创建产品时，生活物联网平台为该产品颁发的全局唯一标识。
categoryKey String 否 value1 产品的品类key。即categoryKey。
homeId String 否 WocVfjef****Wjdf1vfd21f 家的ID，生活物联网平台赋予家的唯一标识符。用于过滤归属在某一个家下的设备列表。
roomId String 否 50f5op15****14b983fd5bca4f2f2 房间的ID，生活物联网平台赋予房间的唯一标识。用于过滤归属在某一个房间下的设备列表。
excludedHomeId String 否 XXX的家 家的ID，生活物联网平台赋予家的唯一标识符。用于过滤不属于某一个家下的设备列表。
excludedRoomId String 否 XXX的房间 房间的ID，生活物联网平台赋予房间的唯一标识。用于过滤不属于某一个房间下的设备列表。
boundControlGroup Boolean 否 true 设备组的绑定状态。true （已绑定设备组），false （未绑定设备组）。
pageNo Int 是 1 分页页码，从1开始。
pageSize Int 是 10 分页大小。取值范围：1~20。
propertyIdentifiers List 否 ["LightSwitch", "PowerSwitch"] 用于过滤产品TSL属性运行态数据的标识符identifier列表。

返回数据

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

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

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

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

响应结果。
total Long

满足条件的设备总数。
pageNo Int

分页页码。
pageSize Int

分页大小。
items JSON

设备的详情列表。
iotId String

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

设备的名称。
homeId String

设备所在家的ID。
homeName String

设备所在家的名称。
roomId String

设备所在房间的ID。
roomName String

设备所在房间的名称。
productKey String

设备所属产品的ProductKey。
productName String

设备所属产品的名称。
productImage String

设备所属产品的图标，如果未定义产品图标，该字段和categoryImage 字段一致。
productModel String

设备所属产品的型号。
categoryKey String

设备所属产品的品类key，即产品的CategoryKey。
categoryImage String

设备所属产品品类的图标。
panelPageRouterUrl String

当categroyKey为Camera时返回该参数，是该设备所属产品的控制面板路由URL。
nickName String

设备的昵称或别名。
netType String

设备的入网类型。
thingType String

设备类型。VIRTUAL（表示虚拟设备）；WEB（表示IoT Studio配置化的Web应用）；APP（表示应用App）；DEVICE（表示实际设备）。
status Int

设备的状态。0（表示未激活）；1（表示在线 ）；3（表示离线）；8（表示禁用）。
nodeType String

设备节点类型。DEVICE（表示设备）； GATEWAY（表示网关）。
description String

设备的描述。
subDeviceIotIdList JSON

当nodeType为GATEWAY时返回该参数，是该设备所属产品的控制面板路由URL。表示绑定该用户的网关的子设备列表。
propertyList JSON

设备的TSL属性状态列表。
identifier String

物模型属性的标识符。
name String

物模型属性的名称。
value String

物模型属性当前状态值。
dataType String

物模型属性值的类型。
imageUrl String

物模型属性的图标URL。
latestUpdateMillis Long

物模型属性状态的最后一次上报时间，格式为UNIX时间戳，单位为毫秒（US）。
protocol String

设备的协议protocol。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2",
		"iotToken": "token"
	},
	"params":{
		"deviceNodeType": "GATEWAY, DEVICE",
		"productKey": "a1U2****UZI",
		"categoryKey": "value1",
		"homeId": "WocVfjef****Wjdf1vfd21f",
		"roomId": "50f5op15****14b983fd5bca4f2f2",
		"excludedHomeId": "XXX的家",
		"excludedRoomId": "XXX的房间",
		"boundControlGroup":true,
		"pageNo":1,
		"pageSize":10,
		"propertyIdentifiers":[
			"LightSwitch",
			"PowerSwitch"
		]
	}
}

正常返回示例

JSON格式 

{
    "id":"4de2c367-c1db-417c-aa15-8c585e595d92",
    "code":200,
    "message":"success",
    "localizedMsg":"",
    "items":{
        "total":2,
        "pageNo":1,
        "pageSize":10,
        "data":[
            {
                "iotId":"edwB6TqvOW2iXnm****a000100",
                "myRole":"OWNED",
                "deviceName":"摄像头1",
                "homeId":"50f5op1556f65de314b983fd5bca4f2f2810****",
                "homeName":"我的家",
                "roomId":"50f5op1556f65de314b983fd5bca4f2f2810****",
                "roomName":"Xbox 游戏室",
                "productKey":"产品 pk",
                "productName":"产品名称",
                "productImage":"产品图片",
                "productModel":"产品型号",
                "categoryKey":"Camera",
                "categoryImage":"xxx",
                "panelPageRouterUrl":"xxx",
                "nickName":"设备昵称",
                "netType":"NET_WIFI",
                "thingType":"DEVICE",
                "status":1,
                "nodeType":"DEVICE",
                "description":"设备描述",
                "subDeviceIotIdList":[
                    "xadqskpHGoswW8lo****000100"
                ],
                "propertyList":[
                    {
                        "identifier":"LightSwitch",
                        "name":"电源开关",
                        "value":"0",
                        "dataType":"BOOL",
                        "imageUrl":"",
                        "latestUpdateMillis":1588145461000
                    }
                ]
            },
            {
                "iotId":"xadqskpHGoswW8l*****00100",
                "myRole":"OWNED",
                "deviceName":"摄像头2",
                "homeId":"50f5op1556f65de314b983fd5bca4f2f2810****",
                "homeName":"我的家",
                "roomId":"50f5op1556f65de314b983fd5bca4f2f2810****",
                "roomName":"Xbox 游戏室",
                "productKey":"产品 pk",
                "productName":"产品名称",
                "productImage":"产品图片",
                "productModel":"产品型号",
                "categoryKey":"Camera",
                "categoryImage":"xxx",
                "panelPageRouterUrl":"xxx",
                "nickName":"设备昵称",
                "netType":"NET_WIFI",
                "thingType":"DEVICE",
                "status":1,
                "nodeType":"DEVICE",
                "description":"设备描述",
                "propertyList":[
                    {
                        "identifier":"LightSwitch",
                        "name":"电源开关",
                        "value":"0",
                        "dataType":"BOOL",
                        "imageUrl":"",
                        "latestUpdateMillis":1588145461000
                    }
                ]
            }
        ]
    }
}

异常返回示例

JSON格式 

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