在鸿云文档

Appearance

简版-网关与子设备获取设备属性 ​

平台可主动发送请求获取设备属性的命令到设备，设备反馈平台需要获取的设备信息上报到平台。

请求topic定义 ​

请求topic：tlink/${productKey}/${deviceName}/command/getProperty/exec

数据流向：平台发布消息，设备监听消息

请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
   "method": "tlink.${productKey}.${deviceName}.command.getProperty.exec",
   "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "data": [
    "Status",
    "Data",
    "DeviceInfo"
  ]
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。全局唯一，用于系统消息追踪
vString是协议版本号，目前协议版本号唯一取值为1
tLong是消息发送时间戳
deviceIdString否设备ID,可能是网关设备自己的id，也可能是子设备的设备id，如果是子设备的id，就获取的子设备的属性数据
methodString否TCP连接时必传
dataObject是需要获取数据的属性列表。
如以上示例代码中，需要获取三个属性，"Status","Data","DeviceInfo"。
如果是自定义模块属性，属性标识符格式为模块标识符:属性标识符（中间为英文冒号），例如[ "test:Status"]。

响应获取设备属性 ​

响应topic定义 ​

设置属性响应的topic说明：tlink/${productKey}/${deviceName}/command/getProperty/exec_reply

数据流向：设备发布消息，平台监听消息

响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
   "method": "tlink.${productKey}.${deviceName}.command.getProperty.exec_reply",
    "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "code": 200,
  "data": {
    "Status":"1",
    "Data":"设备告警",
    "DeviceInfo":["鸿蒙","3568"]
  }
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
deviceIdString否设备ID,可能是网关设备自己的id，也可能是子设备的设备id
codeInteger是结果状态码。成功为200，其他为失败
dataObject是请求成功时，返回的数据。
如以上示例代码中，返回三个属性的数据。