在鸿云文档

Appearance

简版-网关与子设备属性上报 ​

网关或子设备定时或有变动时，主动上报属性数据。

请求topic定义 ​

上报属性请求topic定义：tlink/${productKey}/${deviceName}/event/propertyReport/post

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

请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
  "method": "tlink.${productKey}.${deviceName}.event.propertyReport.post",
  "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "data": {
    "Power": "on",
    "WF": 23.6
  }
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString否消息ID号。全局唯一，用于系统消息追踪
vString否协议版本号，目前协议版本号唯一取值为1
tLong否消息发送时间戳
methodString否TCP连接时必传
deviceIdString否设备ID,可能是网关设备自己的id，也可能是子设备的设备id，如果是子设备的id，就上报的子设备的属性数据
dataObject是请求参数。
如以上示例中，设备上报了的两个属性Power（电源）和WF（工作电流）的信息。属性保存到数据库时，会取协议体里的t字段，如果t字段不传，将会取系统时间。
如果是自定义模块属性，属性标识符格式为模块标识符:属性标识符（中间为英文冒号）。例如：
"test:Power": "on"
  keyString是上报的属性名
  valueother是上报的属性值

响应上报设备属性 ​

响应topic定义 ​

上报属性响应topic说明： tlink/${productKey}/${deviceName}/event/propertyReport/post_reply

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

响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "method": "tlink.${productKey}.${deviceName}.event.propertyReport.post_reply",
  "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "code": 200,
  "data": {}
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
deviceIdString否设备ID,可能是网关设备自己的id，也可能是子设备的设备id
codeInteger是结果状态码。成功为200，其他为失败
dataObject否请求成功时，返回的数据。不需要返回则为空。