调用该接口获取家下设备组内的设备列表。
路径 /living/home/controlgroup/device/query 版本号 1.0.4 协议 HTTPS 请求方法 POST 是否需要用户身份鉴权 是 超时时间 15000请求参数
名称类型是否必选示例值描述 名称 类型 是否必选 示例值 描述 homeId String 是 9f2ca71c99d440018b55ac530987**** 家的ID，生活物联网平台赋予家的唯一标识符。 controlGroupId String 是 9f2ca71c99d440018b55ac530987**** 设备组的 ID，生活物联网平台赋予设备组的唯一标识符。 pageNo Int 是 1 分页页码，从 1 开始。 pageSize Int 是 20 分页大小，取值范围： 1~20。 propertyIdentifiers List 否 ["PowerSwitch", "LightSwitch", "WorkSwitch"] 用于过滤产品TSL属性运行态数据的标识符identifier列表。返回数据
示例
请求示例
{"id": "1509086454180","version": "1.0","request":{"apiVer": "1.0.4","iotToken": "token"},"params":{"homeId": "9f2ca71c99d440018b55ac530987****","controlGroupId": "9f2ca71c99d440018b55ac530987****","pageNo":1,"pageSize":20,"propertyIdentifiers":["PowerSwitch","LightSwitch","WorkSwitch"]} }
正常返回示例
JSON格式
{ "id":"4de2c367-c1db-417c-aa15-8c585e595d92", "code":200, "message":null, "localizedMsg":null, "data":{ "total":1, "pageNo":1, "pageSize":10, "items":[ { "iotId":"xxx1", "deviceName":"摄像头1", "roomId":"xxx", "roomName":"xxx", "productKey":"产品 pk", "productName":"产品名称", "productImage":"产品图片", "productModel":"产品型号", "categoryKey":"Camera", "categoryImage":"xxx", "nickName":"设备昵称", "netType":"", "thingType":"APP", "status":1, "nodeType":"DEVICE", "description":"xxx", "propertyList":[ { "identifier":"LightSwitch", "name":"xx", "value":"xx", "dataType":"xx", "imageUrl":"xx", "latestUpdateMillis":1588145461000 } ] } ] } }
异常返回示例
JSON格式
{ "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284", "code": 403, "message": "request forbidden.", "localizedMsg": "请求被禁止", "data": null }
