获取属性信息¶
设备端从云端获取属性,云端根据需要查询的属性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 | 请求格式不正确 |