DDWiki/产品/开放平台/开放平台接口文档(内部版).md

# 鼎鼎开放平台

鼎鼎开放平台旨在集成物联网设备，赋能合作第三方或内部开发人员，使之可以进行围绕设备、与业务无关的开发。第一版的开放平台开始于2021年1月，对接了深圳曼顿公司物联网空开的`HTTP`和`UDP`协议。

# 版本历史

| 版本  | 修订内容                                                     | 修订人 | 发布日期  |
| ----- | ------------------------------------------------------------ | ------ | --------- |
| 1.0.0 | 第一次发布。功能包括：合闸、分断、获取实时数据。             | 季建新 | 2021.1.12 |
| 1.0.1 | 兼容`UDP`协议                                                | 季建新 | 2021.2.21 |
| 1.0.2 | `HTTP`协议电量查询，实现按月、按天、按小时查询。             | 季建新 | 2021.2.21 |
| 1.0.3 | `UDP`协议电量查询，实现按月、按天、按小时查询。              | 季建新 | 2021.2.21 |
| 1.0.4 | 获取`HTTP`协议模块是否在线; 模块和项目绑定；模块和项目解除绑定；获取60分钟内负荷; 获取任意多开关任意时间段内的电量。 | 季建新 | 2021.3.19 |
| 1.0.5 | 获取项目下的模块；获取项目下的所有模块及线路；获取任意多个线路的累积负荷；获取任意多开关任意时间段内的按小时、按天、按月电量；获取任意多开关任意时间段内的电量。 | 季建新 | 2021.3.22 |
| 1.0.5 | 获取任意多模块任意线路任意时间段内的电压或负荷；获取任意多模块任意线路最近24小时内的电压或负荷 | 季建新 | 2021.4.1  |





# 空气开关

## 获取实时数据

请求

```
POST http://47.103.61.198:5008/api/breaker/data

Headers:

Content-Type: application/json
DD-Open-Key: d2ca79f1-4666-4ad5-953b-7ba5ee480fe0

Body:

{
	"mac":"187ED53338C4"
}
```

响应

```
{
    "data": {
        "serverinfo": {
            "port": "12345",
            "hardware": "T25",
            "execleakcheck": "false",
            "protocol_ver": "19",
            "mac": "187ED53338C4",
            "loginid": "187ED53338C4",
            "gate": "",
            "ip": "192.168.8.134",
            "version": "1.3.08",
            "loginpwd": "7a57a5a743894ae4",
            "ssidpwd": "2803f88db851c67a",
            "ssid": "DDINGW",
            "timezoneId": "Asia/Shanghai",
            "ServerProtocol": "2",
            "server": "47.103.61.198:5008/ebx-bishop/data/carry",
            "datetime": "2021-01-25 14:24:56",
            "leakcheckdate": "3,13,33",
            "lastleakcheckdate": "2017-01-01 10:00:00"
        },
        "distributbox": {
            "breakers": {
                "1": {
                    "version": "1.03",
                    "title": "总路",
                    "model": "JZK2L100-BL6523",
                    "alarm": 0,
                    "enableNetCtrl": true,
                    "mxdw": 0,
                    "mxgg": 14080,
                    "mxgl": 96,
                    "mxgw": 90,
                    "mxgy": 260,
                    "mxld": 30,
                    "mxqy": 0,
                    "openClose": true,
                    "addr": 1,
                    "power": 0,
                    "specification": "64",
                    "control": 1,
                    "visibility": 1,
                    "totalChannelId": -1,
                    "lineType": "220",
                    "a_A": 0,
                    "a_T": 32.1,
                    "a_V": 226,
                    "a_WP": 0,
                    "a_LD": 0.5,
                    "a_PF": 0,
                    "g_A": 0,
                    "g_T": 0,
                    "g_V": 0,
                    "g_WP": 0,
                    "g_LD": 0,
                    "g_PF": 0,
                    "b_A": 0,
                    "b_T": 0,
                    "b_V": 0,
                    "b_WP": 0,
                    "b_PF": 0,
                    "c_A": 0,
                    "c_T": 0,
                    "c_V": 0,
                    "c_WP": 0,
                    "c_PF": 0,
                    "n_A": 0,
                    "n_T": 0
                },
                "2": {
                    "version": "1.03",
                    "title": "线路1",
                    "model": "JZK2L100-BL6523",
                    "alarm": 0,
                    "enableNetCtrl": true,
                    "mxdw": 0,
                    "mxgg": 100,
                    "mxgl": 30,
                    "mxgw": 90,
                    "mxgy": 260,
                    "mxld": 30,
                    "mxqy": 175,
                    "openClose": true,
                    "addr": 2,
                    "power": 0,
                    "specification": "20",
                    "control": 1,
                    "visibility": 1,
                    "totalChannelId": 1,
                    "lineType": "220",
                    "a_A": 0,
                    "a_T": 35,
                    "a_V": 226,
                    "a_WP": 0,
                    "a_LD": 0,
                    "a_PF": 0,
                    "g_A": 0,
                    "g_T": 0,
                    "g_V": 0,
                    "g_WP": 0,
                    "g_LD": 0,
                    "g_PF": 0,
                    "b_A": 0,
                    "b_T": 0,
                    "b_V": 0,
                    "b_WP": 0,
                    "b_PF": 0,
                    "c_A": 0,
                    "c_T": 0,
                    "c_V": 0,
                    "c_WP": 0,
                    "c_PF": 0,
                    "n_A": 0,
                    "n_T": 0
                },
                "3": {
                    "version": "1.03",
                    "title": "线路2",
                    "model": "JZK2L100-BL6523",
                    "alarm": 0,
                    "enableNetCtrl": true,
                    "mxdw": 0,
                    "mxgg": 4400,
                    "mxgl": 30,
                    "mxgw": 90,
                    "mxgy": 260,
                    "mxld": 30,
                    "mxqy": 175,
                    "openClose": true,
                    "addr": 3,
                    "power": 0,
                    "specification": "20",
                    "control": 1,
                    "visibility": 1,
                    "totalChannelId": 1,
                    "lineType": "220",
                    "a_A": 0,
                    "a_T": 35,
                    "a_V": 226,
                    "a_WP": 0,
                    "a_LD": 0,
                    "a_PF": 0,
                    "g_A": 0,
                    "g_T": 0,
                    "g_V": 0,
                    "g_WP": 0,
                    "g_LD": 0,
                    "g_PF": 0,
                    "b_A": 0,
                    "b_T": 0,
                    "b_V": 0,
                    "b_WP": 0,
                    "b_PF": 0,
                    "c_A": 0,
                    "c_T": 0,
                    "c_V": 0,
                    "c_WP": 0,
                    "c_PF": 0,
                    "n_A": 0,
                    "n_T": 0
                }
            },
            "change": null
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 合闸分断

请求

```
POST http://47.103.61.198:5008/api/breaker/oc

Headers:

Content-Type: application/json
DD-Open-Key: d2ca79f1-4666-4ad5-953b-7ba5ee480fe0

Body:

{
	"cmd":"OCSWITCH",
	"value1":"open",
	"value2":"1,2,3",
	"mac":"187ED53338C4",
	"extra":""
}
```



## 批量获取模块是否在线

当总部运营后台展示模块是否在线时使用本接口。



请求

```
POST http://47.103.61.198:5008/api/hd/macs

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"Macs":["187ED5311111","187ED5322222"]
}
```

响应

```
{
    "data": {
        "macs": {
            "187ED5311111": "0",
            "187ED5322222": "0"
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 模块和项目绑定

当总部运营后台绑定模块和项目时使用本接口。



请求

```
POST http://47.103.61.198:5008/api/hd/mac/bind

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"Mac":"187ED5377777",
	"ProjectId":"1000",
	"ProjectName":"DEMO",
	"NSpace":"DEMO",
	"Protocol":0,
	"IsThirdParty":false,
	"APIKey":""
}
```

以上，`Protocol=2`表示模块是`HTTP`通讯，`Protocol=1`表示模块是`UDP`通讯。如果在项目运营后台的组织属于第三方合作方，必须设置`IsThirdParty=true`，并且`APIKey`不能为空。



响应

```
{
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 模块和项目解除绑定

当总部运营后台模块和项目解除绑定时使用本接口。

请求

```
POST http://47.103.61.198:5008/api/hd/mac/unbind

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"Mac":"187ED5377777"
}
```



响应

```
{
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取项目下的模块

请求

```
POST http://47.103.61.198:5008/api/hd/macs/byproject

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"ProjectId":"2"
}
```



响应

```
{
    "data": {
        "macs": [
            "187ED53338C4",
            "187ED5311111",
            "187ED5322222",
            "187ED5333333",
            "187ED5344444",
            "187ED5355555",
            "187ED5366666"
        ],
        "projectId": "2"
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取项目下的所有模块及线路

请求

```
POST http://47.103.61.198:5008/api/hd/addrs/byprojectmac

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"ProjectId":"2"
}
```



响应

```
{
    "data": {
        "projectId": "2",
        "macs": {
            "187ED53338C4": [
                "1",
                "2",
                "3"
            ],
            "187ED5311111": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ],
            "187ED5322222": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ],
            "187ED5333333": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ],
            "187ED5344444": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ],
            "187ED5355555": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ],
            "187ED5366666": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10"
            ]
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```





## 获取最近60分钟的负荷

当需要统计某个项目、公司、位置下的某些开关最近60分钟内负荷时调用本接口。



请求

```
POST http://47.103.61.198:5008/api/breaker/fuhe

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"Macs":["187ED5311111_1,2","187ED5322222_1,2,3"]
}
```



响应

```
{
    "data": {
        "fuHes": [
            {
                "dt": "2021-03-19T14:27:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:28:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:29:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:30:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:31:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:32:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:33:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:34:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:35:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:36:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:37:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:38:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:39:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:40:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:41:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:42:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:43:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:44:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:45:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:46:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:47:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:48:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:49:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:50:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:51:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:52:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:53:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:54:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:55:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:56:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:57:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:58:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T14:59:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:00:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:01:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:02:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:03:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:04:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:05:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:06:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:07:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:08:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:09:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:10:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:11:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:12:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:13:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:14:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:15:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:16:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:17:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:18:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:19:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:20:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:21:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:22:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:23:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:24:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:25:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:26:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:28:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:29:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:30:00",
                "wp": "400"
            },
            {
                "dt": "2021-03-19T15:31:00",
                "wp": "400"
            }
        ]
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多个线路的累积负荷



请求

```
POST http://47.103.61.198:5008/api/breaker/fuhe/byaddr

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"Macs":["187ED5311111_1", "187ED5322222_2"]//一个元素就代表一个开关，不能是187ED5311111_1,2
}
```



响应

```
{
    "data": {
        "macs": {
            "187ED5311111_1": 48.9,
            "187ED5322222_2": 123.8
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```





## 统计任意多开关任意时间段内的总电量



请求

```
POST http://47.103.61.198:5008/api/breaker/power/random

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":15,
	"EndHour":0
}
```



响应：

```
{
    "data": {
        "total": "242.64"
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多开关任意时间段内的按小时、按天、按月电量



请求, 按小时

```
POST http://47.103.61.198:5008/api/breaker/power/random/by

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":5,
	"EndHour":0,
	"PType":"HOURS"
}

```

响应, 按小时

```
{
    "data": {
    	"pType": "HOURS",
        "powers": {
            "2021-03-01 00:00:00.000": 0.72,
            "2021-03-01 01:00:00.000": 0.72,
            "2021-03-01 02:00:00.000": 0.72,
            "2021-03-01 03:00:00.000": 0.72,
            "2021-03-01 04:00:00.000": 0.72,
            "2021-03-01 05:00:00.000": 0.72,
            "2021-03-01 06:00:00.000": 0.72,
            "2021-03-01 07:00:00.000": 0.72,
            "2021-03-01 08:00:00.000": 0.72,
            "2021-03-01 09:00:00.000": 0.72,
            "2021-03-01 10:00:00.000": 0.72,
            "2021-03-01 11:00:00.000": 0.72,
            "2021-03-01 12:00:00.000": 0.72,
            "2021-03-01 13:00:00.000": 0.72,
            "2021-03-01 14:00:00.000": 0.72,
            "2021-03-01 15:00:00.000": 0.72,
            "2021-03-01 16:00:00.000": 0.72,
            "2021-03-01 17:00:00.000": 0.72,
            "2021-03-01 18:00:00.000": 0.72,
            "2021-03-01 19:00:00.000": 0.72,
            "2021-03-01 20:00:00.000": 0.72,
            "2021-03-01 21:00:00.000": 0.72,
            "2021-03-01 22:00:00.000": 0.72,
            "2021-03-01 23:00:00.000": 0.72,
            "2021-03-02 00:00:00.000": 0.72,
            "2021-03-02 01:00:00.000": 0.72,
            "2021-03-02 02:00:00.000": 0.72,
            "2021-03-02 03:00:00.000": 0.72,
            "2021-03-02 04:00:00.000": 0.72,
            "2021-03-02 05:00:00.000": 0.72,
            "2021-03-02 06:00:00.000": 0.72,
            "2021-03-02 07:00:00.000": 0.72,
            "2021-03-02 08:00:00.000": 0.72,
            "2021-03-02 09:00:00.000": 0.72,
            "2021-03-02 10:00:00.000": 0.72,
            "2021-03-02 11:00:00.000": 0.72,
            "2021-03-02 12:00:00.000": 0.72,
            "2021-03-02 13:00:00.000": 0.72,
            "2021-03-02 14:00:00.000": 0.72,
            "2021-03-02 15:00:00.000": 0.72,
            "2021-03-02 16:00:00.000": 0.72,
            "2021-03-02 17:00:00.000": 0.72,
            "2021-03-02 18:00:00.000": 0.72,
            "2021-03-02 19:00:00.000": 0.72,
            "2021-03-02 20:00:00.000": 0.72,
            "2021-03-02 21:00:00.000": 0.72,
            "2021-03-02 22:00:00.000": 0.72,
            "2021-03-02 23:00:00.000": 0.72,
            "2021-03-03 00:00:00.000": 0.72,
            "2021-03-03 01:00:00.000": 0.72,
            "2021-03-03 02:00:00.000": 0.72,
            "2021-03-03 03:00:00.000": 0.72,
            "2021-03-03 04:00:00.000": 0.72,
            "2021-03-03 05:00:00.000": 0.72,
            "2021-03-03 06:00:00.000": 0.72,
            "2021-03-03 07:00:00.000": 0.72,
            "2021-03-03 08:00:00.000": 0.72,
            "2021-03-03 09:00:00.000": 0.72,
            "2021-03-03 10:00:00.000": 0.72,
            "2021-03-03 11:00:00.000": 0.72,
            "2021-03-03 12:00:00.000": 0.72,
            "2021-03-03 13:00:00.000": 0.72,
            "2021-03-03 14:00:00.000": 0.72,
            "2021-03-03 15:00:00.000": 0.72,
            "2021-03-03 16:00:00.000": 0.72,
            "2021-03-03 17:00:00.000": 0.72,
            "2021-03-03 18:00:00.000": 0.72,
            "2021-03-03 19:00:00.000": 0.72,
            "2021-03-03 20:00:00.000": 0.72,
            "2021-03-03 21:00:00.000": 0.72,
            "2021-03-03 22:00:00.000": 0.72,
            "2021-03-03 23:00:00.000": 0.72,
            "2021-03-04 00:00:00.000": 0.72,
            "2021-03-04 01:00:00.000": 0.72,
            "2021-03-04 02:00:00.000": 0.72,
            "2021-03-04 03:00:00.000": 0.72,
            "2021-03-04 04:00:00.000": 0.72,
            "2021-03-04 05:00:00.000": 0.72,
            "2021-03-04 06:00:00.000": 0.72,
            "2021-03-04 07:00:00.000": 0.72,
            "2021-03-04 08:00:00.000": 0.72,
            "2021-03-04 09:00:00.000": 0.72,
            "2021-03-04 10:00:00.000": 0.72,
            "2021-03-04 11:00:00.000": 0.72,
            "2021-03-04 12:00:00.000": 0.72,
            "2021-03-04 13:00:00.000": 0.72,
            "2021-03-04 14:00:00.000": 0.72,
            "2021-03-04 15:00:00.000": 0.72,
            "2021-03-04 16:00:00.000": 0.72,
            "2021-03-04 17:00:00.000": 0.72,
            "2021-03-04 18:00:00.000": 0.72,
            "2021-03-04 19:00:00.000": 0.72,
            "2021-03-04 20:00:00.000": 0.72,
            "2021-03-04 21:00:00.000": 0.72,
            "2021-03-04 22:00:00.000": 0.72,
            "2021-03-04 23:00:00.000": 0.72,
            "2021-03-05 00:00:00.000": 0.72
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



请求, 按天

```
POST http://47.103.61.198:5008/api/breaker/power/random/by

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

Body:

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":5,
	"EndHour":0,
	"PType":"DAY"
}

```

响应, 按天

```
{
    "data": {
        "pType": "DAY",
        "powers": {
            "2021-03-01 00:00:00.000": 42.5,
            "2021-03-02 00:00:00.000": 42.5,
            "2021-03-03 00:00:00.000": 42.5,
            "2021-03-04 00:00:00.000": 42.5,
            "2021-03-05 00:00:00.000": 42.5
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```

请求，按月

```
POST http://47.103.61.198:5008/api/breaker/power/random/by

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"StartYear":2021,
	"StartMonth":1,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":5,
	"EndHour":0,
	"PType":"MONTH"
}
```

响应，按月

```
{
    "data": {
        "pType": "MONTH",
        "powers": {
            "2021-01-01 00:00:00.000": 356,
            "2021-02-01 00:00:00.000": 347,
            "2021-03-01 00:00:00.000": 359
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多开关任意时间段内的电量



请求

```
POST http://47.103.61.198:5008/api/breaker/power/random/byaddr

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"StartYear":2021,
	"StartMonth":1,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":5,
	"EndHour":0
}
```



响应

```
{
    "data": {
        "powers": {
            "187ED5311111_1": 641.15,
            "187ED5322222_2": 398.77
        }
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多模块任意线路的报警

请求

```
POST http://47.103.61.198:5008/api/breaker/warning/bymacs

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"Macs":["187ED5311111_2","187ED53338C4_1"],
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":2,
	"EndHour":0
}
```

响应

```
{
    "data": {
        "warnings": [
            {
                "addr": 2,
                "start": "2021-03-01 04:04:00.000",
                "end": "2021-03-01 05:04:00.000",
                "wtype": "0",
                "level": 3,
                "val": "265 v",
                "limit": "260 V",
                "mac": "187ed5311111",
                "ts": "2021-03-18 15:26:10.724"
            },
            {
                "addr": 2,
                "start": "2021-03-01 05:05:00.000",
                "end": "2021-03-01 06:05:00.000",
                "wtype": "0",
                "level": 3,
                "val": "100 V",
                "limit": "175 V",
                "mac": "187ed5311111",
                "ts": "2021-03-18 15:26:26.468"
            },
			......
        ]
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取某个线路的报警

请求

```
POST http://47.103.61.198:5008/api/breaker/power/random/byaddr

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"Mac":"187ED5311111",
	"Addr":2,
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":0,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":2,
	"EndHour":0
}
```

响应

```
{
    "data": {
        "warnings": [
            {
                "addr": 2,
                "start": "2021-03-01 04:04:00.000",
                "end": "2021-03-01 05:04:00.000",
                "wtype": "0",
                "level": 3,
                "val": "265 v",
                "limit": "260 V",
                "mac": "187ed5311111",
                "ts": "2021-03-18 15:26:10.724"
            },
            {
                "addr": 2,
                "start": "2021-03-01 05:05:00.000",
                "end": "2021-03-01 06:05:00.000",
                "wtype": "0",
                "level": 3,
                "val": "100 V",
                "limit": "175 V",
                "mac": "187ed5311111",
                "ts": "2021-03-18 15:26:26.468"
            },
		......
        ]
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多模块任意线路任意时间段内的电压或负荷

请求

```
POST http://47.103.61.198:5008/api/breaker/real/random

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"StartYear":2021,
	"StartMonth":3,
	"StartDay":1,
	"StartHour":2,
	"EndYear":2021,
	"EndMonth":3,
	"EndDay":5,
	"EndHour":2,
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"Type":1 //Type为0表示请求负荷，为1表示请求电压
}
```



响应

```
{
    "data": {
        "total": "221.495"
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```



## 获取任意多模块任意线路最近24小时内的电压或负荷



请求

```
POST http://47.103.61.198:5008/api/breaker/real/latest

Headers:

Content-Type: application/json
DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3

{
	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
	"Type":0 //Type为0表示请求负荷，为1表示请求电压
}
```

响应

```
{
    "data": {
        "total": "1.162"
    },
    "isError": false,
    "message": "success",
    "code": 200
}
```