在鸿云文档

Appearance

上报设备多模块属性 ​

设备定时或有变动时，主动上报多个模块的属性。

请求topic定义 ​

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

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

请求数据体格式 ​

支持两种数据体格式，如下。

请求格式一 ​

此格式适合，同一时间上报多个属性，属性的时间相同。

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
  "method": "tlink.${productKey}.${deviceName}.event.propertyReport.post",
  "data": [{
		  "module_id": "module1",
		  "property": {
			  "Power": "on",
			  "WF": 23.6
		  }
	  }, {
		  "module_id": "module2",
		  "property": {
			  "Power": "on",
			  "WF": 23.6
		  }
	 }
  ]
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString否消息ID号。全局唯一，用于系统消息追踪
vString否协议版本号，目前协议版本号唯一取值为1
tLong否消息发送时间戳
methodString否TCP连接时必传
dataList是请求模块列表。
如以上示例中，设备上报了的两个模块的属性Power（电源）和WF（工作电流）的信息。属性保存到数据库时，会取协议体里的t字段，如果t字段不传，将会取系统时间。
  module_idString是模块标识符
  propertyObject是对应模块里的具体属性
    keyString是上报的属性名
    valueother是上报的属性值

请求格式二 ​

此格式适合，数据采集场景，同一时间上报多个属性，且每个属性的采集时间不相同。

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
  "method": "tlink.${productKey}.${deviceName}.event.propertyReport.post",
   "data": [{
		  "module_id": "module1",
		  "property": {
			   "Power": {
            "value": "on",
            "t": 1692580951000
          },
          "WF": {
            "value": 23.6,
            "t": 1524448722000
          }
		  }
	  }, {
		  "module_id": "module2",
		  "property": {
			   "Power": {
            "value": "on",
            "t": 1692580951000
          },
          "WF": {
            "value": 23.6,
            "t": 1524448722000
          }
		  }
	 }
  ]
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString否消息ID号。全局唯一，用于系统消息追踪
vString否协议版本号，目前协议版本号唯一取值为1
tLong否消息发送时间戳
methodString否TCP连接时必传
dataList是请求模块列表。
如以上示例中，设备上报了的两个模块的属性Power（电源）和WF（工作电流）的信息。属性保存到数据库时，会取数据体里属性的t字段，如果属性的t字段不传，则会取协议体里的t字段，否则将会取系统时间。
  module_idString是模块标识符
  propertyObject是对应模块里的具体属性
    keyString是上报的属性名
    valueother是上报的属性值
    tLong否属性采集的时间戳

响应上报设备多模块属性 ​

响应topic定义 ​

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

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

响应数据体格式 ​

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

响应参数说明

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