调用该接口根据设备ID查询该设备上所有绑定的账户。

路径 /living/user/device/binding/query
版本号 1.0.0
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
pageNo Int 从1开始的当前查询页码。
pageSize Int 分页大小。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data JSON

绑定用户列表。

total Int

总记录条数。

accountDevList JSON

查询到的用户设备列表。

iotId String

设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

productKey String

产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。

deviceName String

设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。

productName String

设备所隶属的产品名称。

nickName String

用户对设备设置的昵称。

owned Int

用户身份。0(表示分享者);1(表示拥有者)。

identityId String

用户的账号ID。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0"
	},
	"params":{
		"iotId": "value0",
		"pageNo": "value1",
		"pageSize": "value2"
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "data": 
{
    "accountDevList":[
        {
            "deviceName":"00158D00xxxxB3",
            "identityId":"50caop1fxxxxxxxxe55dae27b479165",
            "iotId":"OK61KXgxxxxxxxxtTk000100",
            "nickName":"红外过道2",
            "owned":1,
            "productKey":"a1xxxxyZ",
            "productName":"红外探测器"
        }
    ],
    "total":1
},
    "id":"bb179e80-39fd-xxxx-xxxx-48ca87a3f5c5"
}

异常返回示例

JSON 格式

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