在鸿云文档

Appearance

网关(直连设备)获取拓扑关系 ​

当网关(直连设备)重启或保存在本地的拓扑关系丢失时，可以向平台发送请求获取拓扑关系。

设备获取拓扑关系topic定义 ​

获取拓扑关系请求topic：tlink/${productKey}/${deviceName}/topo/get

数据流向：网关(直连)设备发布消息，平台监听消息

设备获取拓扑关系请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12bbe",
  "v": "1",
  "t": 1630054074378,
   "method": "tlink.${productKey}.${deviceName}.topo.get",
  "data": {}
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。全局唯一，用于系统消息追踪
vString是协议版本号，目前协议版本号唯一取值为1
tLong是消息发送时间戳
methodString否TCP连接时必传
dataObject否请求参数，请求的数据。不需要则为空。

设备获取拓扑关系响应topic定义 ​

响应topic：tlink/${productKey}/${deviceName}/topo/get_reply

数据流向：平台发布消息，网关(直连设备)监听消息

设备获取拓扑关系响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12bbe",
   "method": "tlink.${productKey}.${deviceName}.topo.get_reply",
  "code": 200,
  "data": [
    {
      "deviceName": "sn1234或mac1234",
      "productKey": "a1234******"
      "subList": []
    },
    {
      "deviceName": "sn456或mac456",
      "productKey": "a4567******"
      "subList": [
           {
             "deviceName": "sn789或mac789",
             "productKey": "a789******"
 			},
            {
             "deviceName": "sn001或mac001",
             "productKey": "a001******"
 			}
      ]
    }
  ]
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
codeInteger是结果状态码。成功为200，其他为失败
dataList是请求数据列表。
  productKeyString是一级子设备的产品productKey。
  deviceNameString是一级子设备的唯一标识。
  subListList否二级子设备列表，当二级子设备列表为空时，表示是一级子设备拓扑关系。
当二级子设备不为空时，表示是二级子设备拓扑关系。
    productKeyString是二级子设备的产品productKey。
    deviceNameString是二级子设备的唯一标识。