调用该接口获取用户绑定的设备列表信息。
路径 /uc/listBindingByAccount 版本号 1.0.8 协议 HTTPS 请求方法 POST 是否需要用户身份鉴权 是 超时时间 8000请求参数
名称类型是否必选示例值描述 名称 类型 是否必选 示例值 描述 thingType String 否 DEVICE 待查询设备的类型。取值为:VIRTUAL(表示虚拟设备);DEVICE(表示普通设备);WEB;APP。 nodeType String 否 GATEWAY 要查询的设备的节点类型。取值为:DEVICE(表示设备);GATEWAY(表示网关)。 pageNo Int 是 1 当前页码,从1开始。 pageSize Int 是 100 分页大小,大于等于1,小于等于100。 owned Int 否 0 绑定类型。取值为:0(表示被分享的设备);1(表示拥有的设备);null(表示所有的设备)。 groupId String 否 value 要查询的空间,如家ID、房间ID等。 isSubDevice Boolean 否 true 是否为子设备。归属在某一个网关设备下的设备表示为子设备。取值为:true (表示获取子设备列表);false (表示获取直连设备列表)。返回数据
示例
请求示例
{"id": "1509086454180","version": "1.0","request":{"apiVer": "1.0.8","iotToken": "token"},"params":{"thingType": "DEVICE","nodeType": "GATEWAY","pageNo":1,"pageSize":100,"owned":0,"groupId": "value","isSubDevice":true} }
正常返回示例
JSON格式
{ "id":"4de2c367-c1db-417c-aa15-8c585e595d92", "code":200, "message":null, "localizedMsg":null, "data":{ "total":2, "pageId":1, "pageSize":10, "data":[ { "identityId":"xxx", "iotId":"edwB6TqvOW2iXnmY7TNa000100", "deviceName":"摄像头1", "productKey":"产品 pk", "productName":"产品名称", "productImage":"产品图片", "productModel":"产品型号", "categoryKey":"Camera", "categoryImage":"xxx", "panelPageRouterUrl":"xxx", "nickName":"设备昵称", "netType":"NET_WIFI", "thingType":"DEVICE", "status":1, "owned":1, "nodeType":"DEVICE", "identityAlias":"133xxx", "isSubDevice":false, "gmtModified":"xxx" }, { "identityId":"xxx", "iotId":"xadqskpHGoswW8loL89h000100", "deviceName":"摄像头2", "productKey":"产品 pk", "productName":"产品名称", "productImage":"产品图片", "productModel":"产品型号", "categoryKey":"Camera", "categoryImage":"xxx", "panelPageRouterUrl":"xxx", "nickName":"设备昵称", "netType":"NET_WIFI", "thingType":"DEVICE", "status":1, "owned":1, "nodeType":"DEVICE", "identityAlias":"133xxx", "isSubDevice":false, "gmtModified":"xxx" } ] } }
异常返回示例
JSON格式
{ "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284", "code": 403, "message": "request forbidden.", "localizedMsg": "请求被禁止", "data": null }