Tuya物联网平台设备发现列表上报与设备管理_云市场(Marketplace)-阿里云帮助中心

发现设备列表上报

在一些场景下，网关可以发现新接入的子设备。发现后，需将新接入子设备的信息上报云端，然后通过数据流转到第三方应用，选择将哪些子设备接入该网关。

数据上行。

请求Topic：/sys/${productKey}/${deviceName}/thing/list/found
响应Topic：/sys/${productKey}/${deviceName}/thing/list/found_reply

请求数据格式：

JSON

{
  "id": "123",
  "version": "1.0",
  "sys":{
    "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.list.found"
}

响应数据格式：

JSON

{
  "id": "123",
  "code": 200,
  "data":{}
}

请求参数说明：

参数	类型	说明
id	String	消息ID号。需定义为String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version	String	协议版本号，目前协议版本号唯一取值为1.0。
sys	Object	扩展功能的参数，其下包含各功能字段。说明使用设备端SDK开发时，如果未设置扩展功能，则无此参数，相关功能保持默认配置。
ack	Integer	sys下的扩展功能字段，表示是否返回响应数据。 1：云端返回响应数据。 0：云端不返回响应数据。重要如果未配置该功能，则无此参数，云端默认返回响应数据。
params	List	请求参数，可为空。
deviceName	String	请求方法，取值`thing.topo.get`。
productKey	String	子设备所属产品的ProductKey。
method	String	请求方法，取值`thing.list.found`。

响应参数说明：

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

错误信息：

错误码	消息	描述
460	request parameter error	请求参数错误。
6250	product not found	上报的子设备产品不存在。
6280	devicename not meet specs	上报的子设备的名称不符规范。