调用该接口获取用户绑定的设备列表详情,包括设备详情。通过设置不同的偏移量来查询任意部分的记录,暂不提供总条数查询。

路径 /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 格式

{}