调用该接口查询用户和设备的关系,如果不存在,会返回一个空对象。

路径 /uc/getByAccountAndDev
版本号 1.0.6
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 5ojQaOflI3yp1w4T5abg00106c**** 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

返回数据

名称 类型 示例值 描述
identityId String

用户的身份ID。

iotId String

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

productKey String

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

deviceName String

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

productName String

设备的产品名称。

productImage String

设备的产品图片。

productModel String

设备的产品型号。

nickName String

用户对设备的昵称。

netType String

设备入网类型。

thingType String

设备的类型,根据在生活物联网平台创建设备的方式决定,一般正式量产的设备为DEVICE类型, 可取值: VIRTUAL(表示虚拟设备);VIRTUAL_SHADOW(表示虚拟影子设备);DEVICE(表示普通设备)。

nodeType String

设备的节点类型:DEVICE;GATEWAY。

status Int

设备状态。0(表示未激活);1(表示在线);3(表示离线);8(表示禁用)。

owned Int

0(表示分享者);1(表示拥有者)。

identityAlias String

用户的显示名:mobile,loginName或email。

gmtModified Long

修改绑定的时间。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.6",
		"iotToken": "token"
	},
	"params":{
		"iotId": "5ojQaOflI3yp1w4T5abg00106c****"
	}
}

正常返回示例

JSON 格式

{
"code":200,
"data":{
"productModel":"testProduct",
"iotId":"fy2Z1oZFWZQVii6kkFVM00101e****",
"netType":"NET_WIFI",
"identityId":"5082opabf5192fb1ae453eced9806fbdae6f****",
"thingType":"DEVICE",
"nodeType":"DEVICE",
"productKey":"a1OwE****Nb",
"deviceName":"b65cb59e688e4f74a208592c****fb",
"productName":"0d2a0***95",
"status":3
},
"id":"e2d74ffe-308e-44ee-94a5-9b44a43eabc9"
}

异常返回示例

JSON 格式

{
"code":2063,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"iotIdnotexist"
}