查询用户绑定的设备列表-阿里云帮助中心

调用此接口查看用户账号下所有绑定的设备列表。

路径	/vision/user/bind/device/list
版本号	1.0.0
协议	HTTPS
请求方法	POST
是否需要用户身份鉴权	是
超时时间	10000

请求参数

名称	类型	是否必选	示例值	描述
thingType	String	否	VIRTUAL	查询设备的类型。VIRTUAL：虚拟设备；DEVICE：普通设备；WEB：网页；APP：手机软件
nodeType	String	否	DEVICE	设备的节点类型。DEVICE：设备；GATEWAY：网关
pageNo	Int	是	1	当前页码
pageSize	Int	是	20	分页大小，最大值100
owned	Int	否	1	绑定类型。取值为：0：被分享的设备；1：拥有的设备；不传该参数则查询所有设备
isSubDevice	Boolean	否	true	是否获取子设备。true：获取子设备；false：获取直连设备。

返回数据

名称	类型	示例值	描述
code	Int		结果状态码。200：成功
data	JSON		返回结果
data	JSON		用户绑定的设备列表
productModel	String		产品型号
gmtModified	Long		修改时间
categoryImage	String		产品品类图标
nickName	String		设备昵称
netType	String		设备连网方式
productKey	String		产品Key
nodeType	String		设备节点类型
subDevice	Boolean		是否为子设备
deviceName	String		设备名称
productName	String		产品名称
identityAlias	String		用户昵称
iotId	String		设备IotId
productImage	String		产品图标
identityId	String		用户身份ID
owned	Int		设备和用户的关系。0：表示分享者：1：表示管理员
thingType	String		设备类型
status	Int		设备状态。0：表示未激活；1：表示在线；3：表示离线；8：表示禁用
pageNo	Int		当前页码
pageSize	Int		分页大小
total	Long		绑定的设备总数
pageCount	Int		总页数
message	String		错误码信息
localizedMsg	String		本地语言的错误码信息

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0",
		"iotToken": "token"
	},
	"params":{
		"thingType": "VIRTUAL",
		"nodeType": "DEVICE",
		"pageNo":1,
		"pageSize":20,
		"owned":1,
		"isSubDevice":true
	}
}

正常返回示例

JSON格式

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data": null
}

异常返回示例

JSON格式

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}

错误码

HttpCode	错误码	错误信息	描述
500	500	Internal Error	Internal Error
503	503	Service Unavailable	Service Unavailable
403	403	Request Limited	Request Limited
401	401	Empty Signature	Empty Signature
400	400	Request Format Error	Request Format Error
200	20003	Find Backend Error	Find Backend Error
200	20004	Backend Service Error	Backend Service Error
200	20055	Backend Service Invalid	Request Format Error
200	20056	Hsf Invoke Timeout	Hsf Invoke Timeout
200	401	Request Authorized Error	Request Authorized Error
200	403	Request Forbidden	Request Forbidden
200	500	Server Error	Server Error