获取属性信息

设备端从云端获取属性,云端根据需要查询的属性ID,返回对应的属性内容。当需要查询的属性内容为空时,云端返回设备的所有属性。

上行

  • 请求TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query

  • 响应TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query_reply

请求数据格式

{
 "id": "123",
 "version": "1.0",
 "params": {
   "attributes": ["attr1", "attr2", "attr3"]
 },
 "method": "thing.attribute.query"
}

响应数据格式

{
 "id": "123",
 "code": 200,
 "data": {
   "attr1": {
       "value": 1.0,
       "value2": 9
     },
   "attr2": 1.02,
   "attr3": [1.02, 2.02, 7.93]
 }
}

参数说明

参数

类型

是否必需

描述

id

String

可选

消息 ID 号,保留值

version

String

必需

协议版本号,目前协议版本1.0

params

Object

必需

查询属性所需的参数

attributes

Array

可选

需要查询的属性的标识符的列表。一次最多可查询200个属性。如果为空,云端会将该设备的所有属性返回

method

String

必需

请求方法

attr1

String

必需

查询的属性的标识符

value

Struct

Integer

返回的该属性的详细信息。在本例中,该属性的数据类型为struct,所以为 value 与它的值被返回

code

Integer

必需

结果返回码,200代表请求成功执行

data

JSON

可选

返回的详细信息。JSON格式

结果返回码

返回码

错误消息

释义

1208

Attribute query data format error

请求格式不正确