设备属性
## 设备属性
设备的数据上报方式有两种：
- 标准数据格式 （Dlink JSON）：设备按照服务端定义的标准数据格式生成数据，然后上报数据。
- 透传/自定义：暂不支持
#### 设备上报属性：
上行
- 请求Topic：`/sys/{productKey}/{DID}/thing/event/property/post`
- 响应Topic：`/sys/{productKey}/{DID}/thing/event/property/post_reply`
请求数据格式如下：
```
{
"id": "123",
"version": "1.0",
"params": {
"Power": {
"value": "on",
"time": 1524448722000
},
"WF": {
"value": 23.6,
"time": 1524448722000
}
},
"method": "thing.event.property.post"
}
```
请求参数说明
|参数|类型|说明|
|-|-|-|
|id|string|消息ID号。需定义为String类型的数字，且设备维度唯一。|
|version|string|协议版本号，目前协议版本号为`1.0`。|
|method|string|请求方法。取值：`thing.event.property.post`。|
|params|object|请求参数。如以上示例中，设备上报了的两个属性Power和WF。具体属性信息，包含属性上报时间（time）和上报的属性值（value）。|
|time|long|属性上报时间。该参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。|
|value|object|上报的属性值。|
返回数据格式如下：
```
{
"id": "123",
"code": 200,
"data": {}
}
```
返回参数说明
|参数|类型|说明|
|-|-|-|
|id|string|消息ID号。需定义为String类型的数字，且设备维度唯一。|
|code|number|结果状态码。具体参考设备端通用code。|
|data|object|请求成功时，返回的数据。|
#### 设置设备属性：
下行
- 请求Topic：`/sys/{productKey}/{DID}/thing/service/property/set`
- 响应Topic：`/sys/{productKey}/{DID}/thing/service/property/set_reply`
请求数据格式如下：
```
{
"id": "123",
"version": "1.0",
"params": {
"temperature": "30.5"
},
"method": "thing.service.property.set"
}
```
请求参数说明
|参数|类型|说明|
|-|-|-|
|id|string|消息ID号。需定义为String类型的数字，且设备维度唯一。|
|version|string|协议版本号，目前协议版本号为`1.0`。|
|method|string|请求方法。取值：`thing.service.property.post`。|
|params|object|属性设置参数。如以上示例中，设置属性：`{ "temperature": "30.5" }`。|
返回数据格式如下：
```
{
"id": "123",
"code": 200,
"data": {}
}
```
返回参数说明
|参数|类型|说明|
|-|-|-|
|id|string|消息ID号。需定义为String类型的数字，且设备维度唯一。|
|code|number|结果状态码。具体参考设备端通用code。|
|data|object|请求成功时，返回的数据。|