目的

本文档作为第三方接口功能的辅助说明文档。介绍了数据接口的设计及使用方法,阐述授权第三方用户(应用)如何使用本套接口获取授权范围内等相关数据,使用方法等以供第三方用户获取相关数据。

本文档提供的API服务是奥太云提供的服务,您必须自己承担使用风险和损失。请严格控制接口的访问频率(每秒钟不得超过3次),如果发现存在恶意攻击、蓄意破坏等行为,我们会采取相关措施,并且保留追究相关责任的权利

本文档描述的内容因为版本更新,可能和实际使用有一些不同。我们将会不定期更新文档,请随时关注我们的网站。如果在使用过程中遇到问题,请联系我们的客服人员。

文档制作于2023年12月21日

地址

https://www.examle.com/example/api/,特别说明具体路径请咨询售后获取。

方式

第三方用户与接口以 HTTPS方式进行通信。

格式

通讯结果以JSON格式返回;具体内容会在JSON中进行详细描述,JSON的基本格式如下所示。

1
2
3
4
5
6
7
{
"code":0, ///*接口执行返回码正常为0,其余基本为不正常。
"msg":"success", ///*具体的执行信息
"count":235, ///*表示的请求返回数量,结合具体接口识别
"data":{}, ///*具体的数据内容,如果返回的是单个对象
"list":[] ///*具体的数据列表,如果返回的是对象数组
}

常见code

code msg 说明
0 success 正常响应
-1 xxxx 详细原因请看msg内容
-100 invalid token token异常,不存在等原因
-200 invalid ip 您的ip不在token的白名单中
-300 limit speed 请求访问速率控制
-400 invalid hearders 请求头的headers项存在错误
-500 invalid timestamp 时间戳异常,差值超过10分钟

获取授权

在请求相关接口之前请联系您的目标账号持有人,将token和appSecret分享给您。账号持有人可以登录智慧能源管理平台的个人中心之后,在令牌管理栏查看相关信息。

如果您的账号下没有相关token和appSecret等信息,请联系售前技术支持进行协助生成。

每条授权信息包含token、appSecret、IP白名单、有效期等元素。token和appSecret用以计算每次请求时的请求头元素内容。IP白名单可以对访问的源IP进行限制。该授权项过期后只能重新生成。

header组织

向用户索取授权后,您可以请求访问下列的相关接口,在访问下列接口前必须按照如下的规则进行组织您的请求头。

key value 说明
token token(字符串类型) 用户登录或者授权得到的token
timestamp 字符串类型 时间戳毫秒数,误差10分钟以内
Content-MD5 str1 详见生成规则

md5

  • str = token + & + appSecret + & + timestamp
  • str1 = MD5(str);
  • str1 = BASE64(str1);

原始字符串str为上述组合形式str;得到原始字符串后进行MD5算法,然后进行BASE64编码得到。

校验值的计算

java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
* @description 根据输入的参数进行计算MD5值
* */
public String calculateMD5(String token,String appSecret,String timestamp) {
String content = "";
String str = token + "&" + appSecret + "&" + timestamp;
try {
MessageDigest md = MessageDigest.getInstance("MD5");
byte[] messageDigest = md.digest(str.getBytes());
StringBuffer hexString = new StringBuffer();
for (byte b : messageDigest) {
hexString.append(String.format("%02x", b & 0xff));
}
String md5 = hexString.toString();
content = Base64.getEncoder().encodeToString(md5.getBytes());

} catch (Exception e) {
content = "";
}

System.out.println(str + "----" + content);

return content;
}

输入值

1
2
3
4
5
6
4b035cb5-c6df-4e09-bc04-7783f10187b9

61382140-c334-4adc-b32e-7070c07f9fc8

1234567890

输出值

OGMyNThmMDUyOGM3MzBhNTE0OTFkYTA4MDY4NTExNmY=

JavaScript

1
2
3
var md5 = CryptoJS.MD5("4b035cb5-c6df-4e09-bc04-7783f10187b9&61382140-c334-4adc-b32e-7070c07f9fc8&1234567890");
var md5 = btoa(md5);
console.log(md5);

输入值

1
2
3
4
5
6
4b035cb5-c6df-4e09-bc04-7783f10187b9

61382140-c334-4adc-b32e-7070c07f9fc8

1234567890

输出值

OGMyNThmMDUyOGM3MzBhNTE0OTFkYTA4MDY4NTExNmY=

python

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import hashlib
import base64


def calculate_md5(input_string):
md5_hash = hashlib.md5()
md5_hash.update(input_string.encode('utf-8'))
md5 = base64.b64encode(md5_hash.hexdigest().encode('utf-8')).decode('utf-8')
print(md5)
return md5


# Press the green button in the gutter to run the script.
if __name__ == '__main__':
calculate_md5("4b035cb5-c6df-4e09-bc04-7783f10187b9&61382140-c334-4adc-b32e-7070c07f9fc8&1234567890")

输入值

1
2
3
4
5
6
4b035cb5-c6df-4e09-bc04-7783f10187b9

61382140-c334-4adc-b32e-7070c07f9fc8

1234567890

输出值

OGMyNThmMDUyOGM3MzBhNTE0OTFkYTA4MDY4NTExNmY=

请求接口

逆变器

查询账号下异常逆变器有多少台

通过传入的uid(登录后获取用户账号的uid),获取您账号底下有多少台逆变器正处于异常停机的状态(早上7点至晚上5点之间逆变器功率为0)。

1
2
inverterInfo/selectFaultInverter

get

参数名 类型 描述 是否必须
1
2
3
4
5
6
{
"code":0, ///*0表示正常,其他值表示异常
"msg":"success", ///*请求的结果描述,通常为success,或者为failed
"count":235, ///*逆变器异常停机的数量
"data":null ///*在此处无效
}

查询逆变器的序列号是否已经存在

1
2
inverterInfo/checkInverterSn

get

参数名 类型 描述 是否必须
inverterSn String 逆变器的序列号 true
1
2
3
4
5
6
{
"code": 0, ///*=0正常返回,其他值见msg消息
"msg": "success", ///*消息体正常
"count": 0, ///*忽略
"data": true ///*=true,序列号已经存在于数据库中,已经被其他逆变器占用;=false,这个序列号不存在,没有被占用。
}

查询指定电站的逆变器列表

1
2
inverterInfo/getByPlantId

参数名 类型 长度 描述 是否必须
plantid int >0 排名参数 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"id": 111, ///*逆变器id
"inverterNo": "1", ///*逆变器编号
"inverterAddress": 1, ///*modbus地址
"collectorAddress": 421401027, ///*绑定到采集器的序列号
"model": "ASP-36KTLC", ///*型号
"state": 0,
"control": null,
"register0a": 0,
"register31": 0,
"register29": 0,
"register2a": 0,
"remark1": null,
"remark2": null,
"remark3": null,
"remark4": null,
"roomId": null,
"plantId": 111,
"timezone": 8, ///*时区,中国一般为gmt8
"recordTime": "2021-04-18", ///*添加设备时记录的日期
"invertertype": 0, ///*=0光伏逆变器,
"load": 1,
"panel": 0, ///*接到逆变器上的电池板的单片容量
"panelnum": 0 ///*这种电池板接了多少块
}
]
}

根据逆变器的序列号来查询逆变器信息

1
2
inverterInfo/queryBySerial

参数名 类型 长度 描述 是否必须
serial String >0 逆变器的序列号 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": {
"id": 98108,
"inverterNo": "2",
"inverterAddress": 1,
"collectorAddress": 220426163,
"model": "ASP-110KTLC",
"state": 0,
"control": null,
"register0a": 0,
"register31": 0,
"register29": 0,
"register2a": 0,
"remark1": null,
"remark2": "S1-2",
"remark3": "2022-07-25",
"remark4": null,
"roomId": null,
"plantId": 54159,
"timezone": 8,
"recordTime": "2022-07-25",
"invertertype": 0,
"load": 1,
"panel": 0,
"panelnum": 0
}
}

逆变器数据

查询逆变器最新数据

1
2
inverterDatas/iid/{id}

get

参数名 类型 描述 是否必须
id int 就是以上api中获取的逆变器id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
{
"code":0,
"msg":"SUCCESS",
"count":1, ///*上述三个解释参考以上api均可解决
"data":{
"inverterId":80, ///*你传入的iid
"recordTime":"2020-04-28 11:32:30.436", ///*数据时间
"inverterState":4, ///*逆变器状态,1=正常;2=待机;4=故障;7=离线
"onlineHours":7, ///*逆变器当天发电小时数
"onlineMinutes":15, ///*逆变器当天发电分钟数
"onlineSeconds":32, ///*逆变器当天发电秒数
"alarmInfor1":257, ///*故障字节具体参考modbus协议
"alarmInfor2":257, ///*故障字节具体参考modbus协议
"alarmInfor3":257, ///*故障字节具体参考modbus协议
"alarmInfor4":0, ///*故障字节具体参考modbus协议
"dayMpp":10.8, ///*可忽略,自此往下如果没有标注,那就是可忽略
"mpptVoltage":0.0,
"acVoltage":231.5, ///*A相电压,单位伏特
"acBvoltage":221.9, ///*B相电压,单位伏特
"acCvoltage":256.8, ///*C相电压,单位伏特
"acCurrent":15.69, ///*A相电流,单位安培
"acBcurrent":18.26, ///*B相电流,单位安培
"acCcurrent":17.23, ///*C相电流,单位安培
"acFrequency":49.55, ///*交流频率,单位赫兹
"acMomentaryPower":0.0, ///*交流功率
"reactivePower":0,
"dcMomentaryPower":5, ///*直流1功率,单位kw
"dcMomentaryPower2":4556, ///*直流2功率,单位W
"dcCurrent":8.8, ///*直流1电流,单位安培
"dcVoltage":659.2, ///*直流1电压,单位伏特
"dcCurrent2":7.26, ///*直流2电流,单位安培
"dcVoltage2":592.3, ///*直流2电压,单位伏特
"dayPowerHigh":0, ///*日发电量高16位
"dayPowerLower":0.0, ///*日发电量低16位,高16位*65536+低16位是日发电量值。
"totalPowerHigh":0, ///*参考日发电量的意思表示
"totalPowerLower":19592, ///*参考日发电量的意思表示
"temperature":35.5, ///*逆变器的温度,单位℃
"powerFactor":0.0, ///*功率因数(默认保留)
"co2":4472, ///*CO2的减排量,单位吨
"remark1":null, ///*保留
"remark2":null, ///*保留
"plantId":12, ///*电站的id
"keepLive":3, ///*逆变器数据保活有效性时间,该值在15-0之间,由15每隔一分钟自减1,如果减至0表示已经超过15分钟没有更新数据
"signal":0, ///*忽略
"powerSet":0.0, ///*忽略
"repowerSet":0.0, ///*忽略
"protocolV":0, ///*忽略
"deviceType":0, ///*忽略
"currentSwitch":0, ///*忽略
"current1":0.0, ///*直流支路1电流大小,单位安培
"current2":0.0,
"current3":0.0,
"current4":0.0,
"current5":0.0,
"current6":0.0,
"current7":0.0,
"current8":0.0,
"current9":0.0,
"current10":0.0,
"current11":0.0,
"current12":0.0,
"current13":0.0,
"current14":0.0,
"current15":0.0,
"current16":0.0, ///*直流支路16电流大小,单位安培
"inverterSn":"0", ///*逆变器的序列号,可忽略
"alarmInfor5":0, ///*故障字节5,可忽略
"alarmInfor6":0, ///*故障字节6,可忽略
"dcMomentaryPower3":0.0, ///*直流功率3,
"dcCurrent3":0.0, ///*直流3电流,
"dcVoltage3":0.0, ///*直流3电压
"dcMomentaryPower4":0.0, ///*直流功率4
"dcCurrent4":0.0, ///*直流4电流
"dcVoltage4":0.0, ///*直流4电压
"dcMomentaryPower5":0.0,
"dcCurrent5":0.0,
"dcVoltage5":0.0,
"dcMomentaryPower6":0.0,
"dcCurrent6":0.0,
"dcVoltage6":0.0, ///*懒得写了参考上边吧
"dcVoltageMuxian":0.0, ///*母线电压
"alarmInfor7":0, ///*故障字节7
"iv":0, ///*忽略
"angui":0, ///*忽略
"temperaturedc":0.0, ///*DC侧温度
"dcVoltageMuxian2":0.0, ///*母线2电压
"alarmInfory1":0, ///*忽略
"alarmInfory2":0,
"alarmInfory3":0,
"alarmInfory4":0,
"alarmInfory5":0,
"alarmInfory6":0,
"alarmInfory7":0,
"meterPower":11.0, ///*电表功率
"meterTotal":12.0, ///*电表正向电量
"meterRetotal":13.0, ///*电表反向电量
"inverterNo":"1", ///*逆变器的编号
"outputStatus":0
}
}

查询逆变器的多种参数

1
2
InverterDailyData/getDataById

get

参数名 类型 长度 描述 是否必须
id int >0 从其他接口中获取的逆变器id true
date string =10 yyyy-MM-dd格式的日期,例如2021-10-25 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
{
"code":0,
"msg":"SUCCESS",
"count":133,
"data":null,
"list":[
{ ///*下列的具体字段解释请参考前边的解释就OK(接口5),下列注释中只标注对应param请求时添加的对应项
"recordTime":"2021-10-25 06:32:33.739", ///*record_time
"inverterState":null, ///*inverter_state
"onlineHours":null, ///*online_hours
"onlineMinutes":null, ///*online_minutes
"onlineSeconds":null, ///*算了我也不想写了,对应项遵循mybatis的驼峰命名规则:碰到大写字母在前边加_并且将字母替换成小写,绝大多数就是这样。例如alarmInfor1对应项就是alaram_infor1
"alarmInfor1":null,
"alarmInfor2":null,
"alarmInfor3":null,
"alarmInfor4":null,
"dayMpp":null,
"mpptVoltage":null,
"acVoltage":null,
"acBvoltage":null,
"acCvoltage":null,
"acCurrent":null,
"acBcurrent":null,
"acCcurrent":null,
"acFrequency":null,
"acMomentaryPower":null,
"reactivePower":null,
"dcMomentaryPower":null,
"dcMomentaryPower2":null,
"dcCurrent":null,
"dcVoltage":null,
"dcCurrent2":null,
"dcVoltage2":null,
"dayPowerHigh":null,
"dayPowerLower":null,
"totalPowerHigh":null,
"totalPowerLower":null,
"temperature":null,
"powerFactor":null,
"co2":null,
"remark1":null,
"remark2":null,
"plantId":null,
"signal":null,
"powerSet":null,
"repowerSet":null,
"protocolV":null,
"deviceType":null,
"currentSwitch":null,
"current1":null,
"current2":null,
"current3":null,
"current4":null,
"current5":null,
"current6":null,
"current7":null,
"current8":null,
"current9":null,
"current10":null,
"current11":null,
"current12":null,
"current13":null,
"current14":null,
"current15":null,
"current16":null,
"inverterSn":null,
"alarmInfor5":null,
"alarmInfor6":null,
"dcMomentaryPower3":null,
"dcCurrent3":null,
"dcVoltage3":null,
"dcMomentaryPower4":null,
"dcCurrent4":null,
"dcVoltage4":null,
"dcMomentaryPower5":null,
"dcCurrent5":null,
"dcVoltage5":null,
"dcMomentaryPower6":null,
"dcCurrent6":null,
"dcVoltage6":null,
"dcVoltageMuxian":null,
"alarmInfor7":null,
"iv":null,
"angui":null,
"temperaturedc":null,
"dcVoltageMuxian2":null,
"alarmInfory1":null,
"alarmInfory2":null,
"alarmInfory3":null,
"alarmInfory4":null,
"alarmInfory5":null,
"alarmInfory6":null,
"alarmInfory7":null,
"meterPower":null,
"meterTotal":null,
"meterRetotal":null
}
]
}

查询逆变器的历史数据

1
2
inverterDatas/historyBasicData

get

参数名 类型 长度 描述 是否必须
date String yyyy-MM-dd 日期格式 true
iid int >0 逆变器的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
"code": 0, ///*返回代码
"msg": "SUCCESS", ///*请求结果
"count": 165, ///*list长度
"data": null, ///*忽略
"list": [ ///*数据列表
{
"inverterSn": "Y22119030010", ///*逆变器序列号
"recordTime": "2022-06-28 04:58:05.744", ///*本条数据的时间
"acVoltage": 225.1,
"acBvoltage": 226.2,
"acCvoltage": 225.8, ///*ABC相电压
"acCurrent": 0.12,
"acBcurrent": 0,
"acCcurrent": 0, ///*ABC相电流
"acFrequency": 50.03, ///*频率
"acMomentaryPower": 0, ///*交流功率,千瓦
"dcMomentaryPower": 0, ///*直流1功率,瓦特
"dcMomentaryPower2": 0, ///*直流2功率,瓦特
"dcCurrent": 0,
"dcVoltage": 7.5, ///*直流1电流、电压
"dcCurrent2": 0,
"dcVoltage2": 268.7, ///*直流2电流、电压
"temperature": 21.8 ///*温度
}
]
}

查询指定电站的逆变器实时数据列表

1
2
inverterDatas/getByPlantId

参数名 类型 长度 描述 是否必须
plantid int >0 电站的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
{
"code": 0, ///*=0成功
"msg": "SUCCESS", ///*消息体
"count": 1, ///*list的数量
"data": null,
"list": [ ///*内部包含逆变器的实时数据
{
"inverterId": 111, ///*逆变器的id
"recordTime": "2022-04-22 14:16:41.606", ///*数据的时间戳
"inverterState": 1, ///*逆变器状态
"onlineHours": 8,
"onlineMinutes": 39,
"onlineSeconds": 48,
"alarmInfor1": 0,
"alarmInfor2": 0,
"alarmInfor3": 0,
"alarmInfor4": 0,
"dayMpp": 190.04,
"mpptVoltage": 0,
"acVoltage": 223.3,
"acBvoltage": 224.2,
"acCvoltage": 227.3,
"acCurrent": 13.69,
"acBcurrent": 13.54,
"acCcurrent": 13.8,
"acFrequency": 50,
"acMomentaryPower": 9.2,
"reactivePower": 0,
"dcMomentaryPower": 5,
"dcMomentaryPower2": 3922,
"dcCurrent": 8.4,
"dcVoltage": 645.8,
"dcCurrent2": 5.8,
"dcVoltage2": 677.7,
"dayPowerHigh": 0,
"dayPowerLower": 88.99,
"totalPowerHigh": 0,
"totalPowerLower": 54149,
"temperature": 49.9,
"powerFactor": 0,
"co2": 0,
"remark1": null,
"remark2": null,
"plantId": 23206,
"keepLive": 12,
"signal": 255,
"powerSet": 0,
"repowerSet": 0,
"protocolV": 256,
"deviceType": 15016,
"currentSwitch": 59773,
"current1": 0,
"current2": 0,
"current3": 0,
"current4": 0,
"current5": 0,
"current6": 0,
"current7": 0,
"current8": 0,
"current9": 0,
"current10": 0,
"current11": 0,
"current12": 0,
"current13": 0,
"current14": 0,
"current15": 0,
"current16": 0,
"inverterSn": "000000",
"alarmInfor5": 0,
"alarmInfor6": 0,
"dcMomentaryPower3": 0,
"dcCurrent3": 0,
"dcVoltage3": 0,
"dcMomentaryPower4": 0,
"dcCurrent4": 0,
"dcVoltage4": 0,
"dcMomentaryPower5": 0,
"dcCurrent5": 0,
"dcVoltage5": 0,
"dcMomentaryPower6": 0,
"dcCurrent6": 0,
"dcVoltage6": 0,
"dcVoltageMuxian": 0,
"alarmInfor7": 0,
"iv": 0,
"angui": 0,
"temperaturedc": 0,
"dcVoltageMuxian2": 0,
"alarmInfory1": 0,
"alarmInfory2": 0,
"alarmInfory3": 0,
"alarmInfory4": 0,
"alarmInfory5": 0,
"alarmInfory6": 0,
"alarmInfory7": 0,
"meterPower": 0,
"meterTotal": 0,
"meterRetotal": 0,
"inverterNo": "1",
"outputStatus": 0
}
]
}

用户

查询账号下的电站相关信息

1
2
user/getPlantInfo

get

参数名 类型 描述 是否必须
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"code": 0, ///*返回码
"msg": "SUCCESS", ///*返回信息
"count": 1, ///*可忽略
"data": {
"plantCount": 647, ///*电站总数量
"normalCount": 634, ///*正常电站数量
"standbyCount": 0, ///*待机电站数量
"faultCount": 2, ///*故障电站数量
"offlineCount": 2, ///*离线电站数量
"warnCount":1, ///*告警电站数量
"jiansheCount": 9, ///*建设中电站数量
"dayPower": 29303.22, ///*所有电站的日发电量,单位千瓦时
"capacity": 20112.52, ///*所有电站的装机容量,单位千瓦
"totalPower": 104703037, ///*所有电站的累计发电量,单位千瓦时
"power": 13014.1 ///*所有电站的实时功率,单位千瓦

}
}

附带时间查询账号下的电站相关信息

1
2
user/getPlantInfoWithDate

get

参数名 类型 长度 描述 是否必须
date String yyyy-MM 日期格式 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
"code": 0, ///*返回码
"msg": "SUCCESS", ///*返回信息
"count": 1, ///*可忽略
"data": {
"plantCount": 647, ///*电站总数量
"normalCount": 634, ///*正常电站数量
"standbyCount": 0, ///*待机电站数量
"faultCount": 2, ///*故障电站数量
"offlineCount": 2, ///*离线电站数量
"warnCount":1, ///*告警电站数量
"jiansheCount": 9, ///*建设中电站数量
"dayPower": 29303.22, ///*所有电站的日发电量,单位千瓦时
"capacity": 20112.52, ///*所有电站的装机容量,单位千瓦
"totalPower": 104703037, ///*所有电站的累计发电量,单位千瓦时
"power": 13014.1 ///*所有电站的实时功率,单位千瓦
"monthPower": 1327233.75, ///*指定月份下所有电站的月发电量,单位千瓦时
"yearPower": 14203271.01 ///*指定月份下所有电站的年发电量,单位千瓦时
}
}

查询账号下所有电站的累计发电量柱状图

1
2
user/getTotalBar

get

参数名 类型 描述 是否必须
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"code": 0,
"msg": "SUCCESS",
"count": 0,
"data": {
"data2019": 216696.48,
"data2020": 372440.1,
"data2021": 527250.12,
"data2022": 863541.79,
"data2017": 854.28,
"data2018": 47489.73
}
}

查询账号下所有电站的年发电量柱状图

1
2
user/getYearBar

参数名 类型 长度 描述 是否必须
year String yyyy 当前的日期 true

get

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"code": 0,
"msg": "SUCCESS",
"count": 0,
"data": {///*按照月份进行返回,单位kWh,
"november": 43240.28,
"june": 99185.12,
"september": 93626.14,
"may": 104523.8,
"august": 80315.35,
"january": 43940.11,
"february": 67435.01,
"july": 83246.1,
"october": 70640.71,
"april": 97217.35,
"march": 77958.52
}
}

查询账号下所有电站的月发电量柱状图

1
2
user/getMonthBar

get

参数名 类型 长度 描述 是否必须
date String yyyy-MM 当前的日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": { ////*key-value键值对,日期-发电量(千瓦时)
"2022-08-01": 98197.09,
"2022-08-12": 46221.95,
"2022-08-23": 117433.96,
"2022-08-11": 16712.46,
"2022-08-22": 21851.5,
"2022-08-10": 15655.07,
"2022-08-21": 106791.41,
"2022-08-20": 98218.26,
"2022-08-09": 13909.55,
"2022-08-08": 34548.54,
"2022-08-19": 7885.67,
"2022-08-07": 85313.53,
"2022-08-18": 90663.62,
"2022-08-06": 76593.79,
"2022-08-17": 110156.64,
"2022-08-05": 84593.44,
"2022-08-16": 94690.01,

"2022-08-04": 96491.62,
"2022-08-15": 78254.77,
"2022-08-03": 99314.47,
"2022-08-14": 89595.07,
"2022-08-02": 101020.18,
"2022-08-13": 34803.94,
"2022-08-24": 43005.19
}
}

账号搜索功能:搜索自己的子账号

1
2
user/searchEndUser

get

参数名 类型 长度 描述 是否必须
keyword String >0 关键字 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"id": 111,
"userName": "abcd",
"password": "123456",
"rights": "000000000000000000000000000000",
"remark1": "xxxxx",
"remark2": null,
"phone": "1234567",
"qq": null,
"email": "",
"collectorNo": null,
"remark3": "www",
"remark4": null,
"remark5": null,
"remark6": "tldxny",
"recordTime": "2019-11-05"
}
]
}

电站

查询账号下的空电站信息

1
2
plant/findEmptyPlant

get

参数名 类型 描述 是否必须
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
{
"code":0, ///*代码同上API
"msg":"success", ///*信息同上API(前边这两个基本都同上)
"count":3, ///*空电站数量
"data":null, ///*可忽略
"list":[ ///*详细列表
{ ///*这里边的详细信息,以前有API中介绍,就是电站的基本属性信息,自己参考字面意思即可
"id":xxxxx,
"plantNo":"xxxxx",
"plantName":"PY20赵志美16KW",
"isRoom":"0",
"isEnviroment":"0",
"isBlackflow":"0",
"elecSubsidyPrice":0.0,
"internetPowerPrice":0.0,
"ownPowerPrice":0.0,
"internetPowerOccupy":0.0,
"ownPowerOccupy":0.0,
"remark2":"117.696347|35.649062",
"remark3":null,
"remark4":null,
"remark5":null,
"remark6":null,
"remark1":"武台镇",
"plantUser":"lyhx",
"acpower":0.0,
"eday":0.0,
"etot":0.0,
"plantstate":7,
"planttype":0,
"recordTime":"2021-02-02",
"capacity":16.0,
"capacitybattery":0.0,
"country":"中国",
"province":"山东省",
"city":"临沂市",
"district":"平邑县"
}
]
}

根据关键字搜索账号下的电站

1
2
plant/searchPlant

get

参数名 类型 长度 描述 是否必须
keyword String >0 关键字 true
date String yyyy-MM 当前的日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
"code": 0,
"msg": "SUCCESS",
"count": 1, ///*搜索数量,最大为10
"data": null,
"list": [ ///*返回搜索列表,最大10个元素
{
"plantInfo": { ///*请参考其他接口中进行解析即可
"id": 13665,
"plantNo": "13665",
"plantName": "丁里王世元",
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "116.934271|34.120013",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": null,
"remark1": "萧县丁里王世元",
"plantUser": "szkh",
"acpower": 3.14,
"eday": 9.85,
"etot": 19752,
"plantstate": 7,
"planttype": 0,
"recordTime": "2020-05-11",
"capacity": 6,
"capacitybattery": 0,
"country": "中国",
"province": "安徽省",
"city": "宿州市",
"district": "萧县"
},
"monthPower": 552.3,
"yearPower": 7976.55,
"powerRate": 0.52,
"kpi": 1.64,
"date": "2021-10"
}
]
}

根据参数和参数的范围搜索账号下的电站

1
2
plant/searchPlantWithParam

get

参数名 类型 长度 描述 是否必须
param String >0 power/daypower/totalpower true
min int >0 param的最小值 true
max int >min(比min大) param的最大值 true
date String yyyy-MM 当前的日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
"code": 0,
"msg": "SUCCESS",
"count": 1, ///*忽略
"data": null,
"list": [ ///*返回搜索列表,最大10个元素
{
"plantInfo": { ///*请参考其他接口中进行解析即可
"id": 13665,
"plantNo": "13665",
"plantName": "丁里王世元",
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "116.934271|34.120013",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": null,
"remark1": "萧县丁里王世元",
"plantUser": "szkh",
"acpower": 3.14,
"eday": 9.85,
"etot": 19752,
"plantstate": 7,
"planttype": 0,
"recordTime": "2020-05-11",
"capacity": 6,
"capacitybattery": 0,
"country": "中国",
"province": "安徽省",
"city": "宿州市",
"district": "萧县"
},
"monthPower": 552.3,
"yearPower": 7976.55,
"powerRate": 0.52,
"kpi": 1.64,
"date": "2021-10"
}
]
}

获取排名

1
2
plant/rankList

get

参数名 类型 长度 描述 是否必须
param String >0 排名参数 true
flag boolean true/false 前十名、后十名 true

根据提供的参数来获取账号下所有电站的排名,只能获取针对某一参数的前十名或后十名。param可以为power(功率)、daypower(日发电量)、totalpower(累计发电);flag决定是前十10名(true)还是后十名(false)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
{
"code": 0, ///*成功
"msg": "SUCCESS",
"count": 10, ///*数量
"data": null,
"list": [
{ ///*参考其他接口可以获取,不再赘述
"id": 42542,
"plantNo": "42542",
"plantName": "华康纺织",
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0.85,
"internetPowerOccupy": 100,
"ownPowerOccupy": 0,
"remark2": "118.987158|36.616369",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": "华康纺织",
"remark1": "潍坊",
"plantUser": "13869689089",
"acpower": 0,
"eday": 0,
"etot": 0,
"plantstate": 7,
"planttype": 0,
"recordTime": "2022-04-07",
"capacity": 280,
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "潍坊市",
"district": "潍城区"
}
]
}

获取指定电站的功率曲线

1
2
plant/PlantPowerLine

参数名 类型 长度 描述 是否必须
date String yyyy-MM-dd 日期格式 true
pid int >0 电站的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"code": 0, ///*=0表示成功,其余值见msg
"msg": "SUCCESS",
"count": 1, ///*忽略
"data": {
"time": [ ///*时间点列表
"05:45:00",
"06:00:00",
"06:15:00",
"06:30:00",
"06:45:00",
"07:00:00",
],
"power": [ ///*功率点列表(千瓦)
0.4,
22.8,
79.95,
173.33,
323.59,
521.02,
],
"daypower": 27703.95, ///*当日发电量(千瓦时)
"pid": 57267 ///*电站id
}
}

采集器

查询指定电站的采集器列表

1
2
collectorInfo/getByPlantId

参数名 类型 长度 描述 是否必须
pid int >0 排名参数 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
{
"code": 0,
"msg": "success",
"count": 1,
"data": null,
"list": [
{
"collectorInfo": {
"id": 43249,
"collectorNo": null,
"collectorAddress": 421401027,
"model": "ACCI-V1.0",
"address": null,
"remark1": null,
"remark2": null,
"remark3": null,
"remark4": null,
"plantId": 23206,
"recordTime": "2021-04-18"
},
"shengchan": {
"collectorAddress": 421401027,
"type": "GPRS-USB",
"date": "2021-04-06",
"ccid": "89860443011890047042",
"remark1": null,
"remark2": "4G中试机",
"collectorNo": "1",
"plantId": 23206
},
"simcardTs": {
"iccid": "89860443011890047042",
"imsi": "460046396407042",
"sim": "1440439647042",
"totalRes": "10",
"resUsed": "1.65",
"resFree": "8.35",
"packName": null,
"packTotal": null,
"valtype": null,
"exptype": null
},
"simcardUp": null
}
]
}

Modbus数据

查询Modbus实时分页数据

1
2
modbus/query/{cmd}/{page}/{iid}

get

参数名 类型 描述 是否必须
cmd 十六进制字符串、大写、两位命令码 采集器上传的命令码,例如110K各直流支路cmd为0C(不得写C、oc等不规范格式) true
page int,十进制数据 采集器上传的cmd命令下的第page页数据,例如110K各直流支路page为0 true
iid int,十进制数据 就是以上api中获取的逆变器id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"code":0, ///*代码同上API
"msg":"success", ///*信息同上API(前边这两个基本都同上)
"count":3, ///*空电站数量
"list":null, ///*可忽略
"data":{
"cmd": 12, ///*这就是你上传的cmd的十进制
"collector": 1, ///*对应该iid设备的采集器,这条数据就是通过这个采集器上传的
"iid": 80, ///*这就是你上传的iid
"modbusAddress": 1, ///*这就是iid设备的modbus地址
"modbusUnitList": [ ///*内部是modbus协议中的列表数据,每个modbus寄存器单元
///*addr:modbus寄存器地址,des:寄存器单元意思表示,flag:true表示负数,false表示正数,rate:这个寄存器单元的数据倍数,value:数据单元的真实值。当看到这个描述的时候就很明显了,例如:直流7电压是有符号数,真实值是10.0伏,modbus协议中第128号寄存器
{"addr": "128", "des": "直流7电压", "flag": true, "rate": 0.1, "value": 100},
{"addr": "129", "des": "直流7电流", "flag": false, "rate": 0.01, "value": 100},
{"addr": "130", "des": "直流7功率", "flag": false, "rate": 1.0, "value": 100}
],
"page": 0, ///*这就是你上传的page页数
"pid": 12, ///*这就是这台iid设备位于哪个电站中,pid表示电站的id
"recordTime": "2021-07-16 14:41:53", ///*这表示这条数据的时区时间,该字段已经转换到了对应的时区
"signals": 255, ///*这表示采集器在上传这条数据时的信号强度
"timestamp": {"$numberLong": "1626417710744"}, ///*这表示服务器在处理这条数据时的时间,服务器时间即东八区时间戳
"timezone": 8, ///*这表示这台iid设备位于全球哪个时区,本条示例数据表示东八区北京时区
"_id": {"$oid": "60f12a31fc683807bea3b2d7"} ///*这个可以忽略
}
}

设备故障

根据日期范围查询账号下设备的故障记录

1
2
inverterWarn/getRecord

参数名 类型 长度 描述 是否必须
sdate String yyyy-MM-dd 开始日期 true
edate String yyyy-MM-dd 结束日期 true
type int -1/0/1/2 故障的状态类型 true

type

  • =-1表示全部故障
  • =0 GOING 表示故障还在继续,正在进行的故障;
  • =1 RECOVER 表示故障已经恢复,已经恢复的故障;
  • =2 UNKNOWN 表示数据采集模块已经离线了,状态未知的故障。其实感觉这个状态位可以不进行统计
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"_id": {
"timestamp": 1694495523,
"date": "2023-09-12T05:12:03.000+00:00"
},
"inverterId": 141049,
"plantId": 8863,
"stime": "2023-09-12 10:10:43.879",
"etime": "2023-09-12 10:17:42.739",
"status": 0,
"inverterSn": "",
"meta": [
0,
0,
3584,
0
],
"messagecn": [
"网侧电压C相欠压",
"网侧电压B相欠压",
"网侧电压A相欠压"
],
"messageen": [
"Phase C voltage is too low",
"Phase B voltage is too low",
"Phase A voltage is too low"
],
"plantName": "BrigAshfaq",
"inverterNo": "1"
}
]
}

查询账号下正在发生故障的逆变器故障信息

1
2
inverterWarn/getWarn

附注:该接口用于查询账号下**没有离线的并且正在发生故障的逆变器当前故障信息**。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
"code": 0, ///*0表示正常,其他值异常
"msg": "SUCCESS", ///*消息信息详情
"count": 259, ///*发生故障的逆变器数量==list.size()
"data": null,
"list": [
{
"_id": {
"timestamp": 1662680394,
"date": "2022-09-08T23:39:54.000+00:00"
},
"inverterId": 93871, ///*逆变器id
"plantId": 51904, ///*电站id
"stime": "2022-09-09 07:37:37.353",
"etime": "2022-09-09 07:57:52.757", ///*开始时间与结束时间
"status": 1, ///*故障状态0GOING,1RECOVER,1UNKNOWN
"inverterSn": "Y22210033089", ///*机器序列号
"meta": [ ///*故障初始代码
0,
0,
3584,
64
],
"messagecn": [ ///*中文故障描述
"网侧电压C相欠压",
"网侧电压B相欠压",
"网侧电压A相欠压",
"母线电压欠压"
],
"messageen": [ ///*英文故障描述
"Phase C voltage is too low",
"Phase B voltage is too low",
"Phase A voltage is too low",
"Low bus voltage"
]
}
]
}

数据导出

每隔15分钟导出账号下每台逆变器的发电量

1
2
exportData/quarter

参数名 类型 长度 描述 是否必须
date String yyyy-MM-dd 指定的日期 true
1
/// 数据比较简单自己观看一下

分页数据

分页批量数据的获取一般是分批获取账号下的相关信息,安装商或者集成商账号下有大量的设备和电站,一次性获取需要传输的数据太多需要进行分页获取。

批量查询逆变器实时数据

1
2
inverterDatas/dataPackage

注意事项,每个字段中的注释中**~**表示请忽略,字段太多了码字不易见谅;多个相似字段可能会在最底下那个进行标注注释,码字不易请见谅;

  • page参数请从第0页开始请求,每次系统提供1000个电站中的逆变器;
  • 请求结果中带有count字段,表示您的账号中共有多少个电站,如果少于1000个电站请求一次就行了,如果有1888个电站请求page0和1即可,依次类推谢谢;
  • 如果账号中的电站多大几千个,按1000分页也没几次就请求完了,请每次请求间隔几秒,谢谢。
  • 每次批量请求请间隔至少5分钟,因为数采模块每5分钟左右上传一次数据。所以不必追求所有的数据都是接近最新,我们做不到,按照事实来讲也不可能,谢谢;
参数名 类型 长度 描述 是否必须
page int >=0 请从第0页开始 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
{
"code":0, ///*=0成功,=其他异常
"msg":"", ///*没有消息就是最好的消息否则才查看
"count":1, ///*username中的电站总数量
"data":null, ///*~
"list": ///*分批获取的列表数据内容
[
{
"inverterId":44328, ///*逆变器的id键
"recordTime":"2022-04-16 14:12:53.251", ///*该数据的时间
"inverterState":1, ///*逆变器状态,=1正常,=2待机,=4故障
"onlineHours":8, ///*逆变器并网当日工作小时
"onlineMinutes":42, ///*当日工作分钟
"onlineSeconds":9, ///*当日工作秒
"alarmInfor1":0,
"alarmInfor2":0,
"alarmInfor3":0,
"alarmInfor4":0, ///*故障代码数据
"dayMpp":15.49,
"mpptVoltage":0.0, ///*~
"acVoltage":233.4,
"acBvoltage":234.5,
"acCvoltage":230.4, ///*交流ABC电压单位伏特
"acCurrent":17.2,
"acBcurrent":17.3,
"acCcurrent":17.3, ///*交流ABC电流单位安培
"acFrequency":50.02, ///*交流频率,单位赫兹
"acMomentaryPower":11.97, ///*交流功率,单位千瓦
"reactivePower":0, ///*~
"dcMomentaryPower":5, ///*直流1功率,单位千瓦
"dcMomentaryPower2":5832, ///*直流2功率,单位瓦特
"dcCurrent":11.3, ///*直流1电流,单位安培
"dcVoltage":507.7, ///*直流1电压,单位伏特
"dcCurrent2":11.4, ///*直流2电流,单位安培
"dcVoltage2":509.5, ///*直流2电压,单位伏特
"dayPowerHigh":0, ///*~
"dayPowerLower":83.61, ///*当日发电量,单位千瓦
"totalPowerHigh":1,
"totalPowerLower":18484, ///*累计发电量=totalPowerHigh*65536+totalPowerLower=84020千瓦
"temperature":59.6, ///*逆变器温度,单位℃
"powerFactor":0.0,
"co2":0,
"remark1":null,
"remark2":null, ///*~
"plantId":5120, ///*电站id键
"keepLive":13,
"signal":255,
"powerSet":0.0,
"repowerSet":0.0,
"protocolV":256, ///*~
"deviceType":15005, ///*~
"currentSwitch":31869, ///*~
"current1":0.0,
"current2":0.0,
"current3":0.0,
"current4":0.0,
"current5":0.0,
"current6":0.0,
"current7":0.0,
"current8":0.0,
"current9":0.0,
"current10":0.0,
"current11":0.0,
"current12":0.0,
"current13":0.0,
"current14":0.0,
"current15":0.0,
"current16":0.0, ///*大容量逆变器的16路支路电流,单位安培
"inverterSn":"123456", ///*逆变器的序列号
"alarmInfor5":0,
"alarmInfor6":0, ///*~
"dcMomentaryPower3":0.0,
"dcCurrent3":0.0,
"dcVoltage3":0.0, ///*直流支路3的功率、电流、电压
"dcMomentaryPower4":0.0,
"dcCurrent4":0.0,
"dcVoltage4":0.0, ///*直流支路4的功率、电流、电压
"dcMomentaryPower5":0.0,
"dcCurrent5":0.0,
"dcVoltage5":0.0, ///*直流支路5的功率、电流、电压
"dcMomentaryPower6":0.0,
"dcCurrent6":0.0,
"dcVoltage6":0.0, ///*直流支路6的功率、电流、电压
"dcVoltageMuxian":0.0,
"alarmInfor7":0,
"iv":0,
"angui":0, ///*~
"temperaturedc":0.0,
"dcVoltageMuxian2":0.0,
"alarmInfory1":0,
"alarmInfory2":0,
"alarmInfory3":0,
"alarmInfory4":0,
"alarmInfory5":0,
"alarmInfory6":0,
"alarmInfory7":0,
"meterPower":0.0,
"meterTotal":0.0,
"meterRetotal":0.0,
"inverterNo":"1",
"outputStatus":0 ///*~
}
]
}

查询电站列表

1
2
plant/getByPage

分页获取账号下的电站列表,每页10个电站。

注意事项:

  • 请从page=0开始,page取值0、1、2、3….
  • 返回json中附带了电站的月、年发电量信息,所以参数中会有date项,月、年日期为date中指定的值
参数名 类型 长度 描述 是否必须
page int >=0 分页查询 true
date String yyyy-MM 日期格式 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{
"code": 0, ///*返回码
"msg": "SUCCESS",
"count": 1992, ///*账号下总共有多少个电站
"data": null,
"list": [ ///*每次请求返回的电站列表
{
"plantInfo": {
"id": 8864, ///*电站id
"plantNo": "8864", ///*电站编号
"plantName": "丁里王成功", ///*电站名称
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": "",
"remark1": "丁里王成功",
"plantUser": "wsj001",
"acpower": 3.51, ///*电站功率,单位千瓦
"eday": 4.91, ///*电站当日发电量,千瓦时
"etot": 23190, ///*电站累计发电量,千瓦时
"plantstate": 1, ///*电站状态,=1正常,=0建设中,=2待机,=4故障,=5告警,=7离线


"planttype": 0, ///*光伏电站
"recordTime": "2019-11-05", ///*电站建立日期
"capacity": 6, ///*电站装机容量,千瓦
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "济南市",
"district": "历下区"
},
"monthPower": 346.43, ///*月发电量,千瓦时,参数date指定的月份
"yearPower": 5679.15, ///*年发电量,千瓦时,参数date指定的年份
"powerRate": 0.58, ///*电站功率比,acpower/capacity
"kpi": 0.82, ///*等效小时,eday/capacity
"date": "2022-08" ///*请求参数指定的date
}
]
}

查询电站列表(自定义页大小)

1
2
plant/getByPage**<font style="color:#389E0D;">Size</font>**

分页获取账号下的电站列表,该接口可以根据pageSize的大小来返回具体的数量

注意事项:

  • 请从page=0开始,page取值0、1、2、3….
  • 返回json中附带了电站的月、年发电量信息,所以参数中会有date项,月、年日期为date中指定的值
参数名 类型 长度 描述 是否必须
page int >=0 分页查询 true
date String yyyy-MM 日期格式 true
pageSize int 1-100 每页的大小 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{
"code": 0, ///*返回码
"msg": "SUCCESS",
"count": 1992, ///*账号下总共有多少个电站
"data": null,
"list": [ ///*每次请求返回的电站列表
{
"plantInfo": {
"id": 8864, ///*电站id
"plantNo": "8864", ///*电站编号
"plantName": "丁里王成功", ///*电站名称
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": "",
"remark1": "丁里王成功",
"plantUser": "wsj001",
"acpower": 3.51, ///*电站功率,单位千瓦
"eday": 4.91, ///*电站当日发电量,千瓦时
"etot": 23190, ///*电站累计发电量,千瓦时
"plantstate": 1, ///*电站状态,=1正常,=0建设中,=2待机,=4故障,=5告警,=7离线


"planttype": 0, ///*光伏电站
"recordTime": "2019-11-05", ///*电站建立日期
"capacity": 6, ///*电站装机容量,千瓦
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "济南市",
"district": "历下区"
},
"monthPower": 346.43, ///*月发电量,千瓦时,参数date指定的月份
"yearPower": 5679.15, ///*年发电量,千瓦时,参数date指定的年份
"powerRate": 0.58, ///*电站功率比,acpower/capacity
"kpi": 0.82, ///*等效小时,eday/capacity
"date": "2022-08" ///*请求参数指定的date
}
]
}

单一状态查询电站列表(自定义页大小

1
2
plant/getByPageSizeWith**<font style="color:#389E0D;">One</font>**State

分页获取账号下的电站列表,根据pageSize决定每页返回多少。

按照电站状态进行获取,该接口与前边接口的区别是,前边的接口是按顺序获取电站列表页,该接口能够指定查询电站状态,并且分页

参数名 类型 长度 描述 是否必须
page int >=0 分页查询 true
pageSize int 1-100 页大小 true
date String yyyy-MM 日期格式 true
state int 0、1、2、3、4、5、7 电站的状态 true

注意事项:

  • 请从page=0开始,page取值0、1、2、3….
  • 返回json中附带了电站的月、年发电量信息,所以参数中会有date项,月、年日期为date中指定的值
  • state的取值分别是可以是1、2、3、4、5、7;这个接口与上一个接口的区别就是这个接口更加详细
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
"code": 0, ///*返回码
"msg": "SUCCESS",
"count": 1992, ///*账号下总共有多少个电站
"data": null,
"list": [ ///*每次请求返回的电站列表

{
"plantInfo": {
"id": 8864, ///*电站id
"plantNo": "8864", ///*电站编号
"plantName": "丁里王成功", ///*电站名称
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": "",
"remark1": "丁里王成功",
"plantUser": "wsj001",
"acpower": 3.51, ///*电站功率,单位千瓦
"eday": 4.91, ///*电站当日发电量,千瓦时
"etot": 23190, ///*电站累计发电量,千瓦时
"plantstate": 1, ///*电站状态,=1正常,=0建设中,=2待机,=4故障,=5告警,=7离线


"planttype": 0, ///*光伏电站
"recordTime": "2019-11-05", ///*电站建立日期
"capacity": 6, ///*电站装机容量,千瓦
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "济南市",
"district": "历下区"
},
"monthPower": 346.43, ///*月发电量,千瓦时,参数date指定的月份
"yearPower": 5679.15, ///*年发电量,千瓦时,参数date指定的年份
"powerRate": 0.58, ///*电站功率比,acpower/capacity
"kpi": 0.82, ///*等效小时,eday/capacity
"date": "2022-08" ///*请求参数指定的date
}
]
}

根据参数与排序方向分页查询电站列表

1
2
plant/getRankByPageWithSize

参数名 类型 长度 描述 是否必须
page int >=0 分页查询 true
pageSize int 1-50 页大小 true
date String yyyy-MM 日期,填入当月 true
param String 见后续注释 后续注释 true
flag boolean true/false true递增/false递减 true
  • param的取值power(功率)、daypower(日发电量)、totalpower(总发电量)、monthpower(月发电量)、capacity(装机容量)、kpi(等效小时数)
  • param决定了依照那个参数量排序,flag决定了排序的方向;
  • page与pageSize决定了那一页与页大小
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
"code": 0, ///*=0表示正常,其余值见msg
"msg": "SUCCESS", ///*具体的信息
"count": 29, ///*电站总数量
"data": null,
"list": [ ///*您当前请求的列表
{
"plantInfo": {
"id": 51406,
"plantNo": "51406",
"plantName": "张世英",
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "117.302244|34.813375",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": null,
"remark1": "滕州市后黄庄村",
"plantUser": "H980010002",
"acpower": 4.68,
"eday": 9.51,
"etot": 8521,
"plantstate": 1,
"planttype": 0,
"recordTime": "2022-05-25",
"capacity": 16.35,
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "枣庄市",
"district": "薛城区"
},
"monthPower": 1898.18,
"yearPower": 7067.62,
"powerRate": 0.29,
"kpi": 0.58,
"date": "2022-07"
}
]
}

批量查询账号下电站的月柱状图

1
2
plant/InverterMonthBarWithPage

参数名 类型 长度 描述 是否必须
page int >=0 分页查询 true
pageSize int 1-100 页大小 true
date String yyyy-MM 日期,填入当月 true

按页查询账号下所有逆变器的指定月份的每天发电量,分页以电站为单位,返回结果中会包含页内每个电站的所有逆变器信息。**由于一个电站中可能会有多个逆变器,所以返回的数据可能会比pageSize大;由于逆变器可能会离线(硬件故障或采集模块信号问题),所以返回的数据可能会比pageSize小**;

  • 这个接口的返回是以逆变器为单位的。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
"code": 0, ///*=0表示正常
"msg": "SUCCESS",
"count": 30, ///*电站数量
"data": null,
"list": [ ///*返回的逆变器月柱状图列表
{
"id": 44328, ///*逆变器的id
"power": [ ///*发电量列表,0-30分别表示指定月份的1-31号
95.2,
0,
81.01,
81.23,
84.62,
83.16,
57.24,
24.89,
8.87,
17.42,
40.2,
62.27,
61.48,
82.27,
52.26,
93.7,
95.23,
75.04,
23.76,
88.73,
83.78,
9.25,
102.73,
79.79,
50.42,
96.35,
96.25,
18.66,
26.8,
46.75,
95.61
]
}
]
}

搜索数据

根据采集器序列号或者逆变器序列号查询电站列表

1
2
plant/getBySerial

根据采集器或者逆变器的序列号来搜索对应的电站,最多返回5个结果

参数名 类型 长度 描述 是否必须
date String yyyy-MM 日期格式 true
serial String >0 采集器、逆变器序列号 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
"code": 0, ///*返回码
"msg": "SUCCESS",
"count": 1992, ///*账号下总共有多少个电站
"data": null,
"list": [ ///*每次请求返回的电站列表

{
"plantInfo": {
"id": 8864, ///*电站id
"plantNo": "8864", ///*电站编号
"plantName": "丁里王成功", ///*电站名称
"isRoom": "0",
"isEnviroment": "0",
"isBlackflow": "0",
"elecSubsidyPrice": 0,
"internetPowerPrice": 0,
"ownPowerPrice": 0,
"internetPowerOccupy": 0,
"ownPowerOccupy": 0,
"remark2": "",
"remark3": null,
"remark4": null,
"remark5": null,
"remark6": "",
"remark1": "丁里王成功",
"plantUser": "wsj001",
"acpower": 3.51, ///*电站功率,单位千瓦
"eday": 4.91, ///*电站当日发电量,千瓦时
"etot": 23190, ///*电站累计发电量,千瓦时
"plantstate": 1, ///*电站状态,=1正常,=0建设中,=2待机,=4故障,=5告警,=7离线


"planttype": 0, ///*光伏电站
"recordTime": "2019-11-05", ///*电站建立日期
"capacity": 6, ///*电站装机容量,千瓦
"capacitybattery": 0,
"country": "中国",
"province": "山东省",
"city": "济南市",
"district": "历下区"
},
"monthPower": 346.43, ///*月发电量,千瓦时,参数date指定的月份
"yearPower": 5679.15, ///*年发电量,千瓦时,参数date指定的年份
"powerRate": 0.58, ///*电站功率比,acpower/capacity
"kpi": 0.82, ///*等效小时,eday/capacity
"date": "2022-08" ///*请求参数指定的date
}
]
}

储能数据

根据电站id获取储能电站的概况信息

概况信息包括光伏、电池、用电、电网四元素的功率、日、月、年累计统计量等信息。

1
2
storage/getPlantSummary

参数名 类型 长度 描述 是否必须
pid int >0 电站的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": {
"iid": 0,
"pid": 64394,
"time": null,
"keepLive": 0,
"data00": {
"modbusaddr": 0,
"collector": 0,
"recordTime": null,
"dcv1": 0,
"dcv2": 0,
"dcv3": 0,
"dcv4": 0,
"dcc1": 0,
"dcc2": 0,
"dcc3": 0,
"dcc4": 0,
"dcp1": 0,
"dcp2": 0,
"dcp3": 0,
"dcp4": 0,
"pvm1": 0,
"pvm2": 0,
"pvm3": 0,
"pvm4": 0,
"epvt": 134.8,
"gva": 0,
"gvb": 0,
"gvc": 0,
"gca": 0,
"gcb": 0,
"gcc": 0,
"gfa": 0,
"gfb": 0,
"gfc": 0,
"opa": 0,
"opb": 0,
"opc": 0,
"opt": 0,
"modelId": 0,
"rpa": 0,
"rpb": 0,
"rpc": 0,
"rpt": 0,
"esa": 840.5,
"esd": 0,
"eba": 837.8,
"ebd": 0,
"wht": 0,
"whd": 0,
"pfa": 0,
"pfb": 0,
"pfc": 0,
"gws": 0,
"gps": 0,
"iva": 0,
"ivb": 0,
"ivc": 0,
"ica": 0,
"icb": 0,
"icc": 0,
"ipa": 0,
"ipb": 0,
"ipc": 0,
"ipt": 0,
"eti": 0,
"edi": 0,
"iett": 0,
"ietd": 0,
"ims": 0,
"ifs": 0,
"bv1": 0,
"bv2": 0,
"bc1": 0,
"bc2": 0,
"bcap1": 0,
"bcap2": 0,
"bms1_Alarm": 0,
"bms2_Alarm": 0,
"bms1t": 0,
"bms2t": 0,
"bms1maxc": 0,
"bms2maxc": 0,
"bms1maxd": 0,
"bms2maxd": 0,
"bws1": 0,
"bws2": 0,
"bms1com": 0,
"bms2com": 0,
"esWarning": 0,
"tbd1": 0,
"bh1": 0,
"bh2": 0,
"bts1": 0,
"bts2": 0,
"bms1_warning_code_h": 0,
"bms1_warning_code_l": 0,
"bms2_warning_code_h": 0,
"bms2_warning_code_l": 0,
"llcv1": 0,
"llcv2": 0,
"llcc1": 0,
"llcc2": 0,
"subus": 0,
"mubus": 0,
"bpva": 0,
"bpvb": 0,
"bpvc": 0,
"bpca": 0,
"bpcb": 0,
"bpcc": 0,
"bpfa": 0,
"bpfb": 0,
"bpfc": 0,
"bppa": 0,
"bppb": 0,
"bppc": 0,
"bpp": 0,
"e_Load_Day": 0,
"bpet": 0,
"loads": 0,
"bpvdc": 0,
"bpidc": 0,
"bpwm": 0,
"mpa": 0,
"mpb": 0,
"mpc": 0,
"mpt": 0,
"mcom": 0,
"pversion": 0
},
"data01": {
"modbusaddr": 0,
"collector": 0,
"recordTime": null,
"mpf": 0,
"iwm": 0,
"itemp": 0,
"errorMessage1": 0,
"errorMessage2": 0,
"errorMessage3": 0,
"errorMessage4": 0,
"warningCode1": 0,
"warningCode2": 0,
"fvalue": 0,
"country": 0,
"opmode": 0,
"yearMonth": 0,
"dateHour": 0,
"minuteSecond": 0,
"manufactureId": 0,
"rssi": 0,
"eftwm": 0,
"runm": 0,
"wgPowerMode": 0,
"wgPowerSet": 0,
"diagStatusH": 0,
"diagStatusL": 0,
"gprsBIMode": 0,
"wifis": 0,
"modbusAdd": 0,
"pratedH": 0,
"pratedL": 0,
"modelName": 0,
"hostDeviceFlag": 0,
"drmStatus": 0,
"istr1": 0,
"istr2": 0,
"istr3": 0,
"istr4": 0,
"istr5": 0,
"istr6": 0,
"istr7": 0,
"istr8": 0,
"istr9": 0,
"istr10": 0,
"istr11": 0,
"istr12": 0,
"istr13": 0,
"istr14": 0,
"istr15": 0,
"istr16": 0,
"istrStatus": 0,
"pvev1": 0,
"pvev2": 0,
"pvev3": 0,
"pvev4": 0,
"pvec1": 0,
"pvec2": 0,
"pvec3": 0,
"pvec4": 0,
"geva": 0,
"gevb": 0,
"gevc": 0,
"geca": 0,
"gecb": 0,
"gecc": 0,
"gefa": 0,
"gefb": 0,
"gefc": 0,
"busev": 0,
"lev1": 0,
"lev2": 0,
"lev3": 0,
"lec1": 0,
"lec2": 0,
"lec3": 0,
"lef1": 0,
"lef2": 0,
"lef3": 0,
"llcec": 0,
"llcev": 0,
"buckec": 0,
"ctresult": 0,
"ratedp": 0,
"meterc1": 0,
"meterc2": 0,
"meterc3": 0,
"pload": 0,
"pvEnergyMonth": 1271552.8,
"pvEnergyYear": 1297767.6,
"loadEnergyToday": 20.2,
"loadEnergyMonth": 1338097.7,
"loadEnergyYear": 1364312.5,
"loadEnergySum": 1390527.3,
"gridEnergyMonth": 1416439.9,
"gridEnergyYear": 1442654.7,
"energyReverseMonth": 1468866.8,
"energyReverseYear": 1495081.6,
"inEngeryMonth": 1521268.5,
"inEngeryYear": 1547483.2999999998,
"outEngeryMonth": 1573631,
"outEngeryYear": 1599845.8,
"faultMonth": 0,
"faultHour": 0,
"faultSecond": 0,
"gen_va": 0,
"vstm32": 0,
"vdspm": 0,
"vdsps": 0,
"vcpld": 0,
"edayPv": 16.4,
"edayBatteryCharge": 16.8,
"edayBatteryDischarge": 16.6,
"etotalBatteryCharge": 1114939.0999999999,
"etotalBatteryDischarge": 1141086.8,
"pbattery1": 0,
"pbattery2": 0
},
"data02": {
"modbusaddr": 0,
"collector": 0,
"recordTime": null,
"gen_vb": 0,
"gen_vc": 0,
"gen_ia": 0,
"gen_ib": 0,
"gen_ic": 0,
"gen_ha": 0,
"gen_hb": 0,
"gen_hc": 0,
"gen_pa": 0,
"gen_pb": 0,
"gen_pc": 0,
"gen_p": 0,
"gen_wpa": 0,
"gen_wpb": 0,
"gen_wpc": 0,
"gen_wp": 0,
"gen_ysa": 0,
"gen_ysb": 0,
"gen_ysc": 0,
"starttime": 0,
"ileak": 0,
"gen_eday": 0,
"gen_month": 0,
"gen_year": 0,
"gen_total": 0
},
"dayBar": {
"E-Load-Day": 20.2,
"E-PV-Day": 16.4,
"E-Sell-Day": 0,
"E-Discharging-Day": 16.6,
"E-Charging-Day": 16.8,
"E-Buy-Day": 0
},
"monthBar": {
"E-Charging-Month": 1521268.5,
"E-Sell-Month": 1416439.9,
"E-Discharging-Month": 1573631,
"E-PV-Month": 1271552.8,
"E-Buy-Month": 1468866.8,
"E-Load-Month": 1338097.7
},
"yearBar": {
"E-PV-Year": 1297767.6,
"E-Sell-Year": 1442654.7,
"E-Buy-Year": 1495081.6,
"E-Load-Year": 1364312.5,
"E-Charging-Year": 1547483.2999999998,
"E-Discharging-Year": 1599845.8
},
"totalBar": {
"E-Sell-All": 840.5,
"E-Buy-All": 837.8,
"E-Discharging-All": 1141086.8,
"E-PV-All": 134.8,
"E-Charging-All": 1114939.0999999999,
"E-Load-All": 1390527.3
},
"powers": {
"P-load":0,
"P-inverter":0,
"P-pv":0,
"P-battery":0,
"P-grid":0,
"P-gen":0
}
}
}

这个接口主要是获取储能电站的相关统计信息,将其展示在电站的主页上。本接口主要获取了储能逆变器的实时数据。

根据电站id查询储能逆变器实时数据列表

1
2
storage/getRealDataByPlantId

参数名 类型 长度 描述 是否必须
pid int >0 电站的id true

附注:data00与data01里边的kv太多了,不再一一列举,如真的有需要,请联系单独获取。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"iid": 131089,
"pid": 64394,
"time": "2023-03-09 17:41:47",
"keepLive": 0,
"data00": {
"modbusaddr": 1,
"collector": 13,
"recordTime": "2023-03-04 12:41:35",
"vpv1": 0,
"vpv2": 0.1,
"vpv3": 0.2,
"vpv4": 0.3,
"ipv1": 0.04,
"ipv2": 0.05,
"ipv3": 0.06,
"ipv4": 0.07,
"ppv1": 8,
"ppv2": 9,
"ppv3": 10,
"ppv4": 11,
"pv1Mode": 12,
"pv2Mode": 13,
"pv3Mode": 14,
"pv4Mode": 15,
"modelId": 32,
"e_Total_Grid": 242487,
"e_Day_Grid": 3.9,
"e_Total_Grid_q": 262148.1,
"e_Day_Grid_q": 4.2,
"h_Total_Grid": 281809.2,
"h_Day_grid": 4.5,
"factorGrid1": 0.046,
"factorGrid2": 0.047,
"factorGrid3": 0.048,
"gridMode": 49,
"grid_IO_Flag": 50,
"e_Total_Inverter": 399775.8,
"e_Day_Inverter": 6.3,
"h_Total_Inverter": 419436.9,
"h_Day_Inverter": 6.6,
"inverterMode": 67,
"inverter_IO_Flag": 68,
"bms1_Alarm": 75,
"bms2_Alarm": 76,
"bms1_temperature": 7.7,
"bms2_temperature": 7.8,
"bms1_charge_iMax": 0.79,
"bms2_charge_iMax": 0.8,
"bms1_discharge_iMax": 0.81,
"bms2_discharge_iMax": 0.82,
"battery1_work_mode": 83,
"battery2_work_mode": 84,
"bms1_status": 85,
"bms2_status": 86,
"esWarning": 87,
"tbd1": 88,
"bms1_soh": 0.89,
"bms2_soh": 0.9,
"battery1_mode": 91,
"battery2_mode": 92,
"bms1_warning_code_h": 93,
"bms1_warning_code_l": 94,
"bms2_warning_code_h": 95,
"bms2_warning_code_l": 96,
"u_llc1": 9.7,
"u_llc2": 9.8,
"i_llc1": 0.99,
"i_llc2": 1,
"busVoltage": 10.1,
"nbBusVoltage": 10.2,
"v1Load": 10.3,
"v2Load": 10.4,
"v3Load": 10.5,
"i1Load": 1.06,
"i2Load": 1.07,
"i3Load": 1.08,
"loadPowerL1": 112,
"loadPowerL2": 113,
"loadPowerL3": 114,
"loadPower": 115,
"e_Load_Day": 11.6,
"e_Load_Total": 766783,
"backupMode": 119,
"workModForBP": 122,
"meterStatus": 127,
"vgrid1": 1.8,
"vgrid2": 1.9,
"vgrid3": 2,
"igrid1": 0.21,
"igrid2": 0.22,
"igrid3": 0.23,
"fgrid1": 0.24,
"pgrid": 30,
"qgrid": 36,
"pversion": 31,
"pmeter": 127,
"pv_ETotal": 104859.3,
"fgrid2": 0.25,
"fgrid3": 0.26,
"pgrid1": 27,
"pgrid2": 28,
"pgrid3": 29,
"qgrid1": 33,
"qgrid2": 34,
"qgrid3": 35,
"uinverter1": 5.1,
"uinverter2": 5.2,
"uinverter3": 5.3,
"iinverter1": 0.54,
"iinverter2": 0.55,
"iinverter3": 0.56,
"pinverter1": 57,
"pinverter2": 58,
"pinverter3": 59,
"pinverter": 60,
"vbattery1": 0.69,
"vbattery2": 0.7,
"ibattery1": 0.71,
"ibattery2": 0.72,
"cbattery1": 7.3,
"cbattery2": 7.4,
"fload1": 1.09,
"fload2": 1.1,
"fload3": 1.11,
"vdc_For_BP": 12,
"idc_For_BP": 1.21,
"pmeter1": 123,
"pmeter2": 123,
"pmeter3": 127
},
"data01": {
"modbusaddr": 1,
"collector": 13,
"recordTime": "2023-03-09 17:41:47",
"meterPowerFactor": 0,
"workMode": 1,
"temperature": 0.2,
"errorMessage1": 3,
"errorMessage2": 4,
"errorMessage3": 5,
"errorMessage4": 6,
"warningCode1": 7,
"warningCode2": 8,
"functionVaule": 9,
"safetyCountry": 10,
"operationMode": 11,
"yearMonth": 12,
"dateHour": 13,
"minuteSecond": 14,
"manufactureId": 15,
"rssi": 16,
"effectiveWorkMode": 17,
"effectiveRelayControl": 18,
"wgPowerMode": 19,
"wgPowerSet": 20,
"diagStatusH": 21,
"diagStatusL": 22,
"gprsBIMode": 27,
"pidWietapStatus": 28,
"modbusAdd": 29,
"pratedH": 30,
"pratedL": 31,
"modelName": 32,
"hostDeviceFlag": 33,
"drmStatus": 34,
"istr1": 0.35,
"istr2": 0.36,
"istr3": 0.37,
"istr4": 0.38,
"istr5": 0.39,
"istr6": 0.4,
"istr7": 0.41,
"istr8": 0.42,
"istr9": 0.43,
"istr10": 0.44,
"istr11": 0.45,
"istr12": 0.46,
"istr13": 0.47,
"istr14": 0.48,
"istr15": 0.49,
"istr16": 0.5,
"istrStatus": 51,
"pv1VFaultValue": 5.2,
"pv2VFaultValue": 5.3,
"pv3VFaultValue": 5.4,
"pv4VFaultValue": 5.5,
"pv1IFaultValue": 5.6,
"pv2IFaultValue": 5.7,
"pv3IFaultValue": 5.8,
"pv4IFaultValue": 5.9,
"line1VFaultValue": 6,
"line2VFaultValue": 6.1,
"line3VFaultValue": 6.2,
"line1IFaultValue": 6.3,
"line2IFaultValue": 6.4,
"line3IFaultValue": 6.5,
"line1FFaultValue": 0.66,
"line2FFaultValue": 0.67,
"line3FFaultValue": 0.68,
"busVFaultValue": 6.9,
"load1VFaultValue": 7,
"load2VFaultValue": 7.1,
"load3VFaultValue": 7.2,
"load1IFaultValue": 7.3,
"load2IFaultValue": 7.4,
"load3IFaultValue": 7.5,
"load1FFaultValue": 0.76,
"load2FFaultValue": 0.77,
"load3FFaultValue": 0.78,
"llcIFaultValue": 0.79,
"llcUFaultValue": 8,
"buckBostFaultValue": 0.81,
"ctCheckResult": 91,
"ratedCheckResult": 92,
"meterCurrent1": 0.93,
"meterCurrent2": 0.94,
"meterCurrent3": 0.95,
"loadPower": 96,
"pvEnergyMonth": 635709,
"pvEnergyYear": 648816.4,
"loadEnergyToday": 10.1,
"loadEnergyMonth": 668477.5,
"loadEnergyYear": 681584.9,
"loadEnergySum": 694692.3,
"gridEnergyMonth": 707799.7,
"gridEnergyYear": 720907.1,
"energyReverseMonth": 734014.5,
"energyReverseYear": 747121.9,
"inEngeryMOnth": 760229.3,
"inEngeryYear": 773336.7,
"outEngeryMonth": 786444.1,
"outEngeryYear": 799551.5,
"faultMonth": 123,
"faultHour": 127,
"faultSecond": 127,
"edayPv": 8.2,
"edayBatteryCharge": 8.4,
"edayBatteryDischarge": 8.3,
"vstm32": 23,
"vdspm": 24,
"vdsps": 25,
"vcpld": 26,
"etotalBatteryCharge": 557064.6,
"etotalBatteryDischarge": 570172,
"pbattery1": 89,
"pbattery2": 90
},
"dayBar": {
"E-Load-Day": 10.1,
"E-PV-Day": 8.2,
"E-Sell-Day": 3.9,
"E-Discharging-Day": 8.3,
"E-Charging-Day": 8.4,
"E-Buy-Day": 4.2
},
"monthBar": {
"E-Charging-Month": 760229.3,
"E-Sell-Month": 707799.7,
"E-Discharging-Month": 786444.1,
"E-PV-Month": 635709,
"E-Buy-Month": 734014.5,
"E-Load-Month": 668477.5
},
"yearBar": {
"E-PV-Year": 648816.4,
"E-Sell-Year": 720907.1,
"E-Buy-Year": 747121.9,
"E-Load-Year": 681584.9,
"E-Charging-Year": 773336.7,
"E-Discharging-Year": 799551.5
}
}
]
}

根据逆变器的id获取储能实时数据

1
2
storage/getRealDataByIid

参数名 类型 长度 描述 是否必须
iid int >0 逆变器的id true
1

根据逆变器的id获取储能命令实时数据

1
2
storage/getCmdDataById

参数名 类型 长度 描述 是否必须
iid int >0 逆变器的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": {
"_id": {
"timestamp": 1697700908,
"date": "2023-10-19T07:35:08.000+00:00"
},
"iid": 146887,
"cmd09": {
"recordTime": "2023-10-25 09:01:14",
"keydata": [
152,
153,
154,
155,
156,
157,
158,
159,
160,
161,
162,
163,
164,
165,
166,
167,
168,
169,
170,
171,
172,
173,
174,
175,
176,
177,
178,
179,
180,
181,
182,
183,
184,
185,
186,
187,
188,
189,
190,
191,
192,
193,
194,
195,
196,
197,
198,
199,
200,
201,
202,
203,
204,
205,
206,
207,
208,
209,
210,
211,
212,
213,
214,
215,
216,
217,
218,
219,
220,
221,
222,
223,
224,
225,
226,
227,
228,
229,
230,
231,
232,
233,
234,
235,
236,
237,
238,
239,
240,
241,
242,
243,
244,
245,
246,
247,
248,
249,
250,
251,
252,
253,
254,
255,
256,
257,
258,
259,
260,
261,
262,
263,
264,
265,
266,
267,
268,
269,
270,
271,
272,
273,
274,
275,
276,
277,
278,
21629
],
"modbusaddr": 1,
"collector": 220328032
},
"keepLive": 14,
"pid": 64394,
"time": "2023-10-25 09:01:23",
"cmd08": {
"recordTime": "2023-10-25 09:01:23",
"keydata": [
24,
25,
26,
27,
28,
29,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
49,
50,
51,
52,
53,
54,
55,
56,
57,
58,
59,
60,
61,
62,
63,
64,
65,
66,
67,
68,
69,
70,
71,
72,
73,
74,
75,
76,
77,
78,
79,
80,
81,
82,
83,
84,
85,
86,
87,
88,
89,
90,
91,
92,
93,
94,
95,
96,
97,
98,
99,
100,
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
114,
115,
116,
117,
118,
119,
120,
121,
122,
123,
124,
125,
126,
127,
128,
129,
130,
131,
132,
133,
134,
135,
136,
137,
138,
139,
140,
141,
142,
143,
144,
145,
146,
147,
148,
149,
150,
48253
],
"modbusaddr": 1,
"collector": 220328032
},
"cmd07": {
"recordTime": "2023-10-25 09:01:20",
"keydata": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"modbusaddr": 1,
"collector": 220328032
}
}
}

根据储能逆变器id和日期来获取指定日期的曲线

1
2
storage/getParamLine

参数名 类型 长度 描述 是否必须
iid int >0 储能逆变器的id true
date String yyyy-MM-dd 固定格式日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
{
"code": 0,
"msg": "SUCCESS",
"count": 20,
"data": null,
"list": [
{
"iid": 146887,
"pid": 64394,
"time": "2023-10-26 09:04:44",
"keepLive": 15,
"data00": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:04:41",
"dcv1": 0,
"dcv2": 0.1,
"dcv3": 0.2,
"dcv4": 0.3,
"dcc1": 0.04,
"dcc2": 0.05,
"dcc3": 0.06,
"dcc4": 0.07,
"dcp1": 8,
"dcp2": 9,
"dcp3": 10,
"dcp4": 11,
"pvm1": 12,
"pvm2": 13,
"pvm3": 14,
"pvm4": 15,
"epvt": 104859.3,
"gva": 1.8,
"gvb": 1.9,
"gvc": 2,
"gca": 0.21,
"gcb": 0.22,
"gcc": 0.23,
"gfa": 0.24,
"gfb": 0.25,
"gfc": 0.26,
"opa": 27,
"opb": 28,
"opc": 29,
"opt": 30,
"modelId": 32,
"rpa": 33,
"rpb": 34,
"rpc": 35,
"rpt": 36,
"esa": 242487,
"esd": 3.9,
"eba": 262148.1,
"ebd": 4.2,
"wht": 281809.2,
"whd": 4.5,
"pfa": 0.046,
"pfb": 0.047,
"pfc": 0.048,
"gws": 49,
"gps": 50,
"iva": 5.1,
"ivb": 5.2,
"ivc": 5.3,
"ica": 0.54,
"icb": 0.55,
"icc": 0.56,
"ipa": 57,
"ipb": 58,
"ipc": 59,
"ipt": 60,
"eti": 399775.8,
"edi": 6.3,
"iett": 419436.9,
"ietd": 6.6,
"ims": 67,
"ifs": 68,
"bv1": 0.69,
"bv2": 0.7,
"bc1": 0.71,
"bc2": 0.72,
"bcap1": 7.3,
"bcap2": 7.4,
"bms1_Alarm": 75,
"bms2_Alarm": 76,
"bms1t": 7.7,
"bms2t": 7.8,
"bms1maxc": 0.79,
"bms2maxc": 0.8,
"bms1maxd": 0.81,
"bms2maxd": 0.82,
"bws1": 83,
"bws2": 84,
"bms1com": 85,
"bms2com": 86,
"esWarning": 87,
"tbd1": 88,
"bh1": 0.89,
"bh2": 0.9,
"bts1": 91,
"bts2": 92,
"bms1_warning_code_h": 93,
"bms1_warning_code_l": 94,
"bms2_warning_code_h": 95,
"bms2_warning_code_l": 96,
"llcv1": 9.7,
"llcv2": 9.8,
"llcc1": 0.99,
"llcc2": 1,
"subus": 10.1,
"mubus": 10.2,
"bpva": 10.3,
"bpvb": 10.4,
"bpvc": 10.5,
"bpca": 1.06,
"bpcb": 1.07,
"bpcc": 1.08,
"bpfa": 1.09,
"bpfb": 1.1,
"bpfc": 1.11,
"bppa": 112,
"bppb": 113,
"bppc": 114,
"bpp": 115,
"e_Load_Day": 11.6,
"bpet": 766783,
"loads": 119,
"bpvdc": 12,
"bpidc": 1.21,
"bpwm": 122,
"mpa": 123,
"mpb": 124,
"mpc": 125,
"mpt": 126,
"pversion": 31
},
"data01": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:04:41",
"mcom": 127,
"mpf": 1.28,
"iwm": 129,
"itemp": 13,
"errorMessage1": 131,
"errorMessage2": 132,
"errorMessage3": 133,
"errorMessage4": 134,
"warningCode1": 135,
"warningCode2": 136,
"fvalue": 137,
"country": 138,
"opmode": 139,
"yearMonth": 140,
"dateHour": 141,
"minuteSecond": 142,
"manufactureId": 143,
"rssi": 144,
"eftwm": 145,
"runm": 146,
"wgPowerMode": 147,
"wgPowerSet": 148,
"diagStatusH": 149,
"diagStatusL": 150,
"gprsBIMode": 155,
"wifis": 156,
"modbusAdd": 157,
"pratedH": 158,
"pratedL": 159,
"modelName": 160,
"hostDeviceFlag": 161,
"drmStatus": 162,
"istr1": 1.63,
"istr2": 1.64,
"istr3": 1.65,
"istr4": 1.66,
"istr5": 1.67,
"istr6": 1.68,
"istr7": 1.69,
"istr8": 1.7,
"istr9": 1.71,
"istr10": 1.72,
"istr11": 1.73,
"istr12": 1.74,
"istr13": 1.75,
"istr14": 1.76,
"istr15": 1.77,
"istr16": 1.78,
"istrStatus": 179,
"pvev1": 18,
"pvev2": 18.1,
"pvev3": 18.2,
"pvev4": 18.3,
"pvec1": 18.4,
"pvec2": 18.5,
"pvec3": 18.6,
"pvec4": 18.7,
"geva": 18.8,
"gevb": 18.9,
"gevc": 19,
"geca": 19.1,
"gecb": 19.2,
"gecc": 19.3,
"gefa": 1.94,
"gefb": 1.95,
"gefc": 1.96,
"busev": 19.7,
"lev1": 19.8,
"lev2": 19.9,
"lev3": 20,
"lec1": 20.1,
"lec2": 20.2,
"lec3": 20.3,
"lef1": 2.04,
"lef2": 2.05,
"lef3": 2.06,
"llcec": 2.07,
"llcev": 20.8,
"buckec": 2.09,
"ctresult": 219,
"ratedp": 220,
"meterc1": 2.21,
"meterc2": 2.22,
"meterc3": 2.23,
"pload": 224,
"pvEnergyMonth": 1474582.6,
"pvEnergyYear": 1487690,
"loadEnergyToday": 22.9,
"loadEnergyMonth": 1507351.1,
"loadEnergyYear": 1520458.5,
"loadEnergySum": 1533565.9,
"gridEnergyMonth": 1546673.3,
"gridEnergyYear": 1559780.7,
"energyReverseMonth": 1572888.1,
"energyReverseYear": 1585995.5,
"inEngeryMonth": 1599102.9,
"inEngeryYear": 1612210.3,
"outEngeryMonth": 1625317.7,
"outEngeryYear": 1638425.1,
"faultMonth": 252,
"faultHour": 253,
"vstm32": 151,
"vdspm": 152,
"vdsps": 153,
"vcpld": 154,
"edayPv": 21,
"edayBatteryCharge": 21.2,
"edayBatteryDischarge": 21.1,
"etotalBatteryCharge": 1395938.2,
"etotalBatteryDischarge": 1409045.6,
"pbattery1": 217,
"pbattery2": 218
},
"data02": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:04:44",
"faultSecond": 254,
"gen_va": 25.5,
"gen_vb": 25.6,
"gen_vc": 25.7,
"gen_ia": 2.58,
"gen_ib": 2.59,
"gen_ic": 2.6,
"gen_ha": 2.61,
"gen_hb": 2.62,
"gen_hc": 2.63,
"gen_pa": 264,
"gen_pb": 265,
"gen_pc": 266,
"gen_p": 267,
"gen_wpa": 268,
"gen_wpb": 269,
"gen_wpc": 270,
"gen_wp": 271,
"gen_ysa": 0.272,
"gen_ysb": 0.273,
"gen_ysc": 0.274,
"starttime": 275,
"ileak": 27.6,
"gen_eday": 27.7,
"gen_month": 1821928.7,
"gen_year": 1835036.1,
"gen_total": 1848230.1
},
"powers": {
"P-load": 224,
"P-inverter": 60,
"P-pv": 38,
"soc": 7.35,
"P-battery": 435,
"P-grid": 126,
"P-gen": 267
},
"dayBar": {
"E-Load-Day": 22.9,
"E-PV-Day": 21,
"E-Sell-Day": 3.9,
"E-Discharging-Day": 21.1,
"E-Charging-Day": 21.2,
"E-Gen-Day": 27.7,
"E-Buy-Day": 4.2
},
"monthBar": {
"E-Charging-Month": 1599102.9,
"E-Sell-Month": 1546673.3,
"E-Discharging-Month": 1625317.7,
"E-PV-Month": 1474582.6,
"E-Buy-Month": 1572888.1,
"E-Load-Month": 1507351.1,
"E-Gen-Month": 1821928.7
},
"yearBar": {
"E-PV-Year": 1487690,
"E-Sell-Year": 1559780.7,
"E-Buy-Year": 1585995.5,
"E-Gen-Year": 1835036.1,
"E-Load-Year": 1520458.5,
"E-Charging-Year": 1612210.3,
"E-Discharging-Year": 1638425.1
},
"totalBar": {
"E-Sell-All": 242487,
"E-Gen-All": 1848230.1,
"E-Buy-All": 262148.1,
"E-Discharging-All": 1409045.6,
"E-PV-All": 104859.3,
"E-Charging-All": 1395938.2,
"E-Load-All": 1533565.9
}
},
{
"iid": 146887,
"pid": 64394,
"time": "2023-10-26 09:08:46",
"keepLive": 15,
"data00": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:08:40",
"dcv1": 0,
"dcv2": 0.1,
"dcv3": 0.2,
"dcv4": 0.3,
"dcc1": 0.04,
"dcc2": 0.05,
"dcc3": 0.06,
"dcc4": 0.07,
"dcp1": 8,
"dcp2": 9,
"dcp3": 10,
"dcp4": 11,
"pvm1": 12,
"pvm2": 13,
"pvm3": 14,
"pvm4": 15,
"epvt": 104859.3,
"gva": 1.8,
"gvb": 1.9,
"gvc": 2,
"gca": 0.21,
"gcb": 0.22,
"gcc": 0.23,
"gfa": 0.24,
"gfb": 0.25,
"gfc": 0.26,
"opa": 27,
"opb": 28,
"opc": 29,
"opt": 30,
"modelId": 32,
"rpa": 33,
"rpb": 34,
"rpc": 35,
"rpt": 36,
"esa": 242487,
"esd": 3.9,
"eba": 262148.1,
"ebd": 4.2,
"wht": 281809.2,
"whd": 4.5,
"pfa": 0.046,
"pfb": 0.047,
"pfc": 0.048,
"gws": 49,
"gps": 50,
"iva": 5.1,
"ivb": 5.2,
"ivc": 5.3,
"ica": 0.54,
"icb": 0.55,
"icc": 0.56,
"ipa": 57,
"ipb": 58,
"ipc": 59,
"ipt": 60,
"eti": 399775.8,
"edi": 6.3,
"iett": 419436.9,
"ietd": 6.6,
"ims": 67,
"ifs": 68,
"bv1": 0.69,
"bv2": 0.7,
"bc1": 0.71,
"bc2": 0.72,
"bcap1": 7.3,
"bcap2": 7.4,
"bms1_Alarm": 75,
"bms2_Alarm": 76,
"bms1t": 7.7,
"bms2t": 7.8,
"bms1maxc": 0.79,
"bms2maxc": 0.8,
"bms1maxd": 0.81,
"bms2maxd": 0.82,
"bws1": 83,
"bws2": 84,
"bms1com": 85,
"bms2com": 86,
"esWarning": 87,
"tbd1": 88,
"bh1": 0.89,
"bh2": 0.9,
"bts1": 91,
"bts2": 92,
"bms1_warning_code_h": 93,
"bms1_warning_code_l": 94,
"bms2_warning_code_h": 95,
"bms2_warning_code_l": 96,
"llcv1": 9.7,
"llcv2": 9.8,
"llcc1": 0.99,
"llcc2": 1,
"subus": 10.1,
"mubus": 10.2,
"bpva": 10.3,
"bpvb": 10.4,
"bpvc": 10.5,
"bpca": 1.06,
"bpcb": 1.07,
"bpcc": 1.08,
"bpfa": 1.09,
"bpfb": 1.1,
"bpfc": 1.11,
"bppa": 112,
"bppb": 113,
"bppc": 114,
"bpp": 115,
"e_Load_Day": 11.6,
"bpet": 766783,
"loads": 119,
"bpvdc": 12,
"bpidc": 1.21,
"bpwm": 122,
"mpa": 123,
"mpb": 124,
"mpc": 125,
"mpt": 126,
"pversion": 31
},
"data01": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:08:43",
"mcom": 127,
"mpf": 1.28,
"iwm": 129,
"itemp": 13,
"errorMessage1": 131,
"errorMessage2": 132,
"errorMessage3": 133,
"errorMessage4": 134,
"warningCode1": 135,
"warningCode2": 136,
"fvalue": 137,
"country": 138,
"opmode": 139,
"yearMonth": 140,
"dateHour": 141,
"minuteSecond": 142,
"manufactureId": 143,
"rssi": 144,
"eftwm": 145,
"runm": 146,
"wgPowerMode": 147,
"wgPowerSet": 148,
"diagStatusH": 149,
"diagStatusL": 150,
"gprsBIMode": 155,
"wifis": 156,
"modbusAdd": 157,
"pratedH": 158,
"pratedL": 159,
"modelName": 160,
"hostDeviceFlag": 161,
"drmStatus": 162,
"istr1": 1.63,
"istr2": 1.64,
"istr3": 1.65,
"istr4": 1.66,
"istr5": 1.67,
"istr6": 1.68,
"istr7": 1.69,
"istr8": 1.7,
"istr9": 1.71,
"istr10": 1.72,
"istr11": 1.73,
"istr12": 1.74,
"istr13": 1.75,
"istr14": 1.76,
"istr15": 1.77,
"istr16": 1.78,
"istrStatus": 179,
"pvev1": 18,
"pvev2": 18.1,
"pvev3": 18.2,
"pvev4": 18.3,
"pvec1": 18.4,
"pvec2": 18.5,
"pvec3": 18.6,
"pvec4": 18.7,
"geva": 18.8,
"gevb": 18.9,
"gevc": 19,
"geca": 19.1,
"gecb": 19.2,
"gecc": 19.3,
"gefa": 1.94,
"gefb": 1.95,
"gefc": 1.96,
"busev": 19.7,
"lev1": 19.8,
"lev2": 19.9,
"lev3": 20,
"lec1": 20.1,
"lec2": 20.2,
"lec3": 20.3,
"lef1": 2.04,
"lef2": 2.05,
"lef3": 2.06,
"llcec": 2.07,
"llcev": 20.8,
"buckec": 2.09,
"ctresult": 219,
"ratedp": 220,
"meterc1": 2.21,
"meterc2": 2.22,
"meterc3": 2.23,
"pload": 224,
"pvEnergyMonth": 1474582.6,
"pvEnergyYear": 1487690,
"loadEnergyToday": 22.9,
"loadEnergyMonth": 1507351.1,
"loadEnergyYear": 1520458.5,
"loadEnergySum": 1533565.9,
"gridEnergyMonth": 1546673.3,
"gridEnergyYear": 1559780.7,
"energyReverseMonth": 1572888.1,
"energyReverseYear": 1585995.5,
"inEngeryMonth": 1599102.9,
"inEngeryYear": 1612210.3,
"outEngeryMonth": 1625317.7,
"outEngeryYear": 1638425.1,
"faultMonth": 252,
"faultHour": 253,
"vstm32": 151,
"vdspm": 152,
"vdsps": 153,
"vcpld": 154,
"edayPv": 21,
"edayBatteryCharge": 21.2,
"edayBatteryDischarge": 21.1,
"etotalBatteryCharge": 1395938.2,
"etotalBatteryDischarge": 1409045.6,
"pbattery1": 217,
"pbattery2": 218
},
"data02": {
"modbusaddr": 1,
"collector": 220328032,
"recordTime": "2023-10-26 09:08:46",
"faultSecond": 254,
"gen_va": 25.5,
"gen_vb": 25.6,
"gen_vc": 25.7,
"gen_ia": 2.58,
"gen_ib": 2.59,
"gen_ic": 2.6,
"gen_ha": 2.61,
"gen_hb": 2.62,
"gen_hc": 2.63,
"gen_pa": 264,
"gen_pb": 265,
"gen_pc": 266,
"gen_p": 267,
"gen_wpa": 268,
"gen_wpb": 269,
"gen_wpc": 270,
"gen_wp": 271,
"gen_ysa": 0.272,
"gen_ysb": 0.273,
"gen_ysc": 0.274,
"starttime": 275,
"ileak": 27.6,
"gen_eday": 27.7,
"gen_month": 1821928.7,
"gen_year": 1835036.1,
"gen_total": 1848230.1
},
"powers": {
"P-load": 224,
"P-inverter": 60,
"P-pv": 38,
"soc": 7.35,
"P-battery": 435,
"P-grid": 126,
"P-gen": 267
},
"dayBar": {
"E-Load-Day": 22.9,
"E-PV-Day": 21,
"E-Sell-Day": 3.9,
"E-Discharging-Day": 21.1,
"E-Charging-Day": 21.2,
"E-Gen-Day": 27.7,
"E-Buy-Day": 4.2
},
"monthBar": {
"E-Charging-Month": 1599102.9,
"E-Sell-Month": 1546673.3,
"E-Discharging-Month": 1625317.7,
"E-PV-Month": 1474582.6,
"E-Buy-Month": 1572888.1,
"E-Load-Month": 1507351.1,
"E-Gen-Month": 1821928.7
},
"yearBar": {
"E-PV-Year": 1487690,
"E-Sell-Year": 1559780.7,
"E-Buy-Year": 1585995.5,
"E-Gen-Year": 1835036.1,
"E-Load-Year": 1520458.5,
"E-Charging-Year": 1612210.3,
"E-Discharging-Year": 1638425.1
},
"totalBar": {
"E-Sell-All": 242487,
"E-Gen-All": 1848230.1,
"E-Buy-All": 262148.1,
"E-Discharging-All": 1409045.6,
"E-PV-All": 104859.3,
"E-Charging-All": 1395938.2,
"E-Load-All": 1533565.9
}
}
]
}

根据储能电站id和日期来获取相关的曲线

1
2
storage/getPlantParamLine

参数名 类型 长度 描述 是否必须
pid int >0 储能电站的id true
date String yyyy-MM-dd 固定格式日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"code": 0,
"msg": "SUCCESS",
"count": 23,
"data": null,
"list": [
{
"P-load": 224,
"P-inverter": 60,
"P-pv": 38,
"soc": 7.35,
"P-battery": 435,
"time": "09:33",
"P-grid": 126,
"P-gen": 267
}
]
}

储能柱状图

根据电站id和日期来获取储能电站的月柱状图

1
2
storageBar/getPlantMonthBar

参数名 类型 长度 描述 是否必须
pid int >0 储能电站的id true
date String yyyy-MM 固定格式日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"code": 0,
"msg": "SUCCESS",
"count": 7,
"data": null,
"list": [
{
"_id": {
"timestamp": 1697700918,
"date": "2023-10-19T07:35:18.000+00:00"
},
"date": "2023-10-19",
"inverterId": 146887,
"data": {
"E-Load-Day": 0, //用电量
"E-PV-Day": 0, //发电量
"E-Sell-Day": 0, //并网量
"E-Discharging-Day": 0, //放电量
"E-Charging-Day": 0, //充电量
"E-Buy-Day": 0 //购电量
},
"plantId": 64394
}
]
}

根据电站id和日期来获取储能电站的年柱状图

1
2
storageBar/getPlantYearBar

参数名 类型 长度 描述 是否必须
pid int >0 储能电站的id true
date String yyyy 固定格式日期 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
"code": 0,
"msg": "SUCCESS",
"count": 2,
"data": null,
"list": [
{
"E-Charging-Month": 1520458.6,
"E-Sell-Month": 1415599.4,
"E-Discharging-Month": 1572888.2,
"E-PV-Month": 1271418,
"E-Buy-Month": 1468029,
"E-Load-Month": 1336955,
"date": "s_march"
},
{
"E-Charging-Month": 3198205.8,
"E-Sell-Month": 3093346.6,
"E-Discharging-Month": 3250635.4,
"E-PV-Month": 2949165.2,
"E-Buy-Month": 3145776.2,
"E-Load-Month": 3014702.2,
"E-Gen-Month": 3643857.4,
"date": "s_october"
}
]
}

根据电站id来获取储能电站的历年柱状图

1
2
storageBar/getPlantYearsBar

参数名 类型 长度 描述 是否必须
pid int >0 储能电站的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"E-PV-Year": 2136506.4,
"E-Sell-Year": 2280687.8,
"E-Buy-Year": 2333117.4,
"E-Load-Year": 2202043.4,
"E-Charging-Year": 2385547,
"E-Discharging-Year": 2437976.6,
"date": "s_data2023"
}
]
}

根据逆变器id来获取单台储能逆变器的月度柱状图

1
2
storageBar/getStorageMonthBar

参数名 类型 长度 描述 是否必须
iid int >0 储能逆变器的id true
date String yyyy-MM 日期格式 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
"code": 0,
"msg": "SUCCESS",
"count": 7,
"data": null,
"list": [
{
"_id": {
"timestamp": 1697700918,
"date": "2023-10-19T07:35:18.000+00:00"
},
"date": "2023-10-19",
"inverterId": 146887,
"data": {
"E-Load-Day": 0,
"E-PV-Day": 0,
"E-Sell-Day": 0,
"E-Discharging-Day": 0,
"E-Charging-Day": 0,
"E-Buy-Day": 0
},
"plantId": 64394
},
{
"_id": {
"timestamp": 1697762079,
"date": "2023-10-20T00:34:39.000+00:00"
},
"date": "2023-10-20",
"inverterId": 146887,
"data": {
"E-Load-Day": 0,
"E-PV-Day": 0,
"E-Sell-Day": 0,
"E-Discharging-Day": 0,
"E-Charging-Day": 0,
"E-Buy-Day": 0
},
"plantId": 64394
}
]
}

根据逆变器id来获取单台储能逆变器的年度柱状图

1
2
storageBar/getStorageYearBar

参数名 类型 长度 描述 是否必须
iid int >0 储能逆变器的id true
date String yyyy 日期格式 true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"_id": {
"timestamp": 1695612738,
"date": "2023-09-25T03:32:18.000+00:00"
},
"inverterId": 146887,
"plantId": 64394,
"september": {
"power": 466.65,
"meter": 0,
"remeter": 0
},
"s_october": {
"E-Charging-Month": 1599102.9,
"E-Sell-Month": 1546673.3,
"E-Discharging-Month": 1625317.7,
"E-PV-Month": 1474582.6,
"E-Buy-Month": 1572888.1,
"E-Load-Month": 1507351.1,
"E-Gen-Month": 1821928.7
},
"october": {
"power": 167.25,
"meter": 0,
"remeter": 0
}
}
]
}

根据逆变器id来获取单台储能逆变器的历年柱状图

1
2
storageBar/getStorageYearsBar

参数名 类型 长度 描述 是否必须
iid int >0 储能逆变器的id true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
"code": 0,
"msg": "SUCCESS",
"count": 1,
"data": null,
"list": [
{
"_id": {
"timestamp": 1695612802,
"date": "2023-09-25T03:33:22.000+00:00"
},
"inverterId": 146887,
"plantId": 64394,
"data2023": {
"power": 633.9,
"meter": 0,
"remeter": 0
},
"s_data2023": {
"E-PV-Year": 1487690,
"E-Sell-Year": 1559780.7,
"E-Buy-Year": 1585995.5,
"E-Gen-Year": 1835036.1,
"E-Load-Year": 1520458.5,
"E-Charging-Year": 1612210.3,
"E-Discharging-Year": 1638425.1
}
}
]
}