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

路径 /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"
}