调用该接口获取用户绑定的设备列表详情,包括设备详情。通过设置不同的偏移量来查询任意部分的记录,暂不提供总条数查询。
路径 | /cloud/device/queryByUser |
版本号 | 1.0.7 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
openId | String | 否 | 三方用户外标。openId和identityId不可同时为空,必须填写一个。当传openId时,则openIdAppKey为必传。 | |
openIdAppKey | String | 否 | 32****44 | 三方平台颁发的应用AppKey(云端唯一身份)。 |
identityId | String | 否 | 用户身份ID。openId和identityId不可同时为空,必须填写一个。 | |
limit | Int | 否 | 获取个数限制,取值不可超过100。1.0.5版本新增的参数。 | |
offset | Int | 否 | 偏移量,1.0.5版本新增的参数。 | |
isSubDevice | Boolean | 否 | false | 是否为子设备。归属在某一个网关设备下的设备表示为子设备。取值为:true (表示获取子设备列表);false (表示获取直连设备列表)。 |
nodeType | String | 否 | DEVICE | 要查询的设备的节点类型。取值为:DEVICE(表示设备);GATEWAY(表示网关)。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.7"
},
"params":{
"openId": "value0",
"openIdAppKey": "32****44",
"identityId": "value2",
"limit": "value3",
"offset": "value4",
"isSubDevice":false,
"nodeType": "DEVICE"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"code": 200,
"data": [{
"iotId": "VPuHLddp6fisYryXdk0T0010db****",
"identityId": "50ceop3441838d879e23f01933ab455be61f****",
"netType": "NET_WIFI",
"thingType": "DEVICE",
"productKey": "a1FN****hpQ",
"deviceName": "VD_sd****TXeQ",
"productName": "风扇3-复制",
"status": 3,
"logicType":"0"
}],
"message": "success"
},
"id": "55428a70-a740-4b54-bd7f-89f727744740"
}
异常返回示例
JSON
格式
{
"code":2407,
"message":"openId invalid"
}