调用该接口获取用户绑定的设备列表详情,包括设备详情。通过设置不同的偏移量来查询任意部分的记录,暂不提供总条数查询。
路径 | /cloud/device/queryByUser |
版本号 | 1.0.6 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
openId | String | 否 | 三方用户外标。openId和identityId不可同时为空,必须填写一个。 | |
openIdAppKey | String | 否 | 三方平台颁发的应用AppKey。 | |
identityId | String | 否 | 用户身份ID。openId和identityId不可同时为空,必须填写一个。 | |
limit | Int | 否 | 获取个数限制,取值不可超过100。1.0.5版本新增的参数。 | |
offset | Int | 否 | 偏移量,1.0.5版本新增的参数。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
identityId | String |
用户的身份ID。 |
|
iotId | String |
设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
|
productKey | String |
产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。 |
|
deviceName | String |
设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。 |
|
productName | String |
设备所属产品的名称。 |
|
categoryImage | String |
设备所属的产品图片。 |
|
productModel | String |
设备所属产品的型号。 |
|
nickName | String |
设备的昵称或别名。 |
|
netType | String |
产品下设备的联网方式,可取值: NET_LORA(表示LoRa);NET_CELLULAR(表示2G/3G/4G/5G蜂窝网);NET_WIFI(表示Wi-Fi);NET_ZIGBEE(表示ZigBee);NET_ETHERNET(表示以太网);NET_OTHER(表示其他网络类型)。 |
|
thingType | String |
物的类型, 可取值: VIRTUAL(表示虚拟设备);VIRTUAL_SHADOW(表示虚拟影子设备);DEVICE(表示普通设备);WEB;APP。 |
|
owned | Int |
分享标记。0(表示普通用户,即分享者); 1(表示管理员,即拥有者)。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.6"
},
"params":{
"openId": "value0",
"openIdAppKey": "value1",
"identityId": "value2",
"limit": "value3",
"offset": "value4"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"code": 200,
"data": [{
"iotId": "VPuHLddp6fisYryXdk0T0010db****",
"identityId": "50ceop3441838d879e23f01933ab455be61f****",
"netType": "NET_WIFI",
"thingType": "DEVICE",
"productKey": "a1FNS8TYhpQ",
"deviceName": "VD_sdDaqyTXeQ",
"productName": "风扇3-复制",
"status": 3
}],
"message": "success"
},
"id": "55428a70-a740-4b54-bd7f-89f727744740"
}
异常返回示例
JSON
格式
{}
在文档使用中是否遇到以下问题
更多建议
匿名提交