Tuya物联网平台子设备上线_云市场(Marketplace)-阿里云帮助中心

子设备下线

子设备可以逐个上下线，也可以批量上下线。子设备上线之前，需在物联网平台为子设备注册身份，建立子设备与网关的拓扑关系。子设备上线时，物联网平台会根据拓扑关系进行子设备身份校验，以确定子设备是否具备使用网关通道的能力。

说明

子设备上下线、批量上下线消息，只支持QoS=0，不支持QoS=1。
一个网关下，同时在线的子设备数量不能超过1000。在线子设备数量达到1000个后，新的子设备上线请求将被拒绝。
发送子设备批量上下线请求时，单个批次上下线的子设备数量不超过50个。
设备批量上下线请求结果为全部成功或全部失败，失败时的data响应参数中会包含具体的设备信息。

子设备下线

数据上行：

请求Topic：/ext/session/${productKey}/${deviceName}/combine/logout
响应Topic：/ext/session/${productKey}/${deviceName}/combine/logout_reply

说明

因为子设备通过网关通道与物联网平台通信，以上Topic为网关设备的Topic。Topic中变量${productKey}和${deviceName}需替换为网关设备的对应信息。

请求数据格式：

JSON

{
  "id": "123",
  "params": {
    "productKey": "al12345****",
    "deviceName": "device1234"
  }
}

说明

消息体中，参数productKey和deviceName的值是子设备的对应信息。

参数说明：

参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
params	Object	请求入参，包含要下线的子设备信息。

params参数说明：

参数	类型	说明
deviceName	String	子设备的设备名称。
productKey	String	子设备所属产品的ProductKey。

响应数据格式：

JSON

{
  "id": "123",
  "code": 200,
  "message": "success",
  "data": {
      "deviceName": "device1234",
      "productKey": "al12345****"
    }
}

请求参数说明：

参数	类型	说明
id	String	消息ID，String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
code	Integer	返回结果，200代表成功。
message	String	返回结果信息。
data	Object	请求成功或失败时，返回的下线的子设备信息。具体参数请参见下表data。

data参数说明：

参数	类型	说明
deviceName	String	子设备的设备名称。
productKey	String	子设备所属产品的密钥。

错误信息：

错误码	错误信息	描述
460	request parameter error	请求参数错误。
429	rate limit, too many subDeviceOnline msg in one minute	460	request parameter error	请求参数错误。
		520	device no session	子设备会话不存在。

子设备批量下线

重要

单次最多可请求50个子设备上线。

数据上行：

请求Topic：/ext/session/${productKey}/${deviceName}/combine/batch_logout
响应Topic：/ext/session/${productKey}/${deviceName}/combine/batch_logout_reply

说明

因为子设备通过网关通道与物联网平台通信，以上Topic为网关设备的Topic。Topic中变量${productKey}和${deviceName}需替换为网关设备的对应信息。

请求数据格式：

JSON

{
  "id": "123",
  "params":[{
    "productKey": "al12345****",
    "deviceName": "device1234"
  },{
    "productKey": "al12345****",
    "deviceName": "device4321"
  }]
}

说明

消息体中，参数productKey和deviceName的值是子设备的对应信息。

params参数说明：

参数	类型	说明
deviceName	String	子设备的设备名称。
productKey	String	子设备所属产品的ProductKey。

响应数据格式：

JSON

{
  "id":"123",
  "code":"200",
  “message":"success",
  "data":[{
    "productKey": "al12345****"
    "deviceName": "device1234"
  },{
    "deviceName": "device4321",
    "productKey": "al12345****"
  }]
}

参数说明：

参数	类型	说明
id	String	消息ID，String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
code	Integer	返回结果，200代表成功。
message	String	返回结果信息。
data	Object	请求成功或失败时，返回的下线的子设备信息。具体参数请参见下表data。

data参数说明：

参数	类型	说明
deviceName	String	子设备的设备名称。
productKey	String	子设备所属产品的ProductKey。

错误信息：

错误码	错误信息	描述
460	request parameter error	请求参数错误。
520	device no session	子设备会话不存在。