# 数据访问接口

## API接口一览表

| 接口分类   | 接口描述        | API接口                        | 权限                         |
|--------|-------------|------------------------------| ---------------------------- |
| 数据查询 | 实时数据查询   | /api/data/snapshot   |                              |
|        | 历史区间数据查询 | /api/data/history   |        |
|        | 历史断面数据查询 | /api/data/history/snapshot   |        |


### 数据查询接口

#### 实时数据查询

POST 请求接口

> /api/data/snapshot

请求参数


```json
{
    "deviceId":"129476828342323",
    "attributes":["power","windSpeed","dailyUsageHours","monthlyUsageHours"]
}
```
入参描述

| 参数名       | 参数类型 | 可选 | 描述   |
| ------------ | -------- | ---- |------|
| deviceId   | String   | no  | 设备ID |
| attributes   | StringArray   | no  | 要查询实时数据的设备属性列表 |

返回报文

```json
{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": {
        "power": 56.2,
        "windSpeed": 45.3,
        "dailyUsageHours": 20,
        "monthlyUsageHours": 78,
        ....
    }
}
```
返参描述

data 中以字典的方式，返回查询的属性的实时值。