策略-需量管理与防逆流
上报防逆流过需策略
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/list/post平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/list/post
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_list
streaming_overdemand_list
data
data消息内容
-
见Payload - data
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload - data: StreamingOverDemand
参数类型是否必填描述范围样例id
int过需逆流策略ID
1
device_type
int设备类型
2-储能设备
3-光伏
4-充电桩
2
devices
any设备列表
-
[]emsDevice/[]photovoltaic/[]pail
elemeter
eleMeter电表
-
eleMeter
ele_meter_id
int电表id
1
streaming_status
int防逆流状态
1-启用
2-禁用
1
streaming_condition
int防逆流执行条件（单位：kW）
-
5000
individual_phase_streaming_status
int单相防逆流状态
1-启用
2-禁用
2
individual_phase_streaming_condition
int单相防逆流执行条件（单位：kW）
-
100
over_demand_condition
[]int每月防过需执行条件（1-12月）（单位：kW）
-
[5000,6000,5000,5000,6000,5000,5000,6000,5000,5000,6000,5000]
over_demand_status
int防过需状态
1-启用
2-禁用
1
dynamic_demand
int动态需量（单位：kW）
6000
dynamic_demand_percentage
float动态需量追峰比例
90.1
current_over_demand_condition
int当前月份的过需条件（单位：kW）
2000
updated_by
str更新人
user: 1-admin
created_at
str创建时间
2024-06-06T08:59:20.21309056Z
updated_at
str更新时间
2024-06-06T08:59:20.21309056Z
Payload - emsDevice
参数类型是否必填描述范围样例name
str设备名称
-
ems设备
site_name
str站点名称
-
ems站点
location
str详细地理位置
-
wudun
longitude
float经度
-
-
latitude
float纬度
-
level
intEMS等级
[1, 2]
1
type
str设备类型
-
ems
running_status
int运行状态
1-运行
2-离线
3-故障
[1,2,3]
1
host
str地址
-
192.168.0.1
port
str端口
[0,65525]
2171
license
str激活码
-
2YIZedmOtl4pcqo1EA4zhM5gofDI
Payload - eleMeter
参数类型是否必填描述样例uid
str电表UID
-
QmqEhterhgrzS66grew-1
station_name
str站点名称
-
站点1
port
int端口
[0,65535]
1
name
str设备名称
-
东区变压器
elec_device_type
eleDeviceType电表类型对象
-
-
rate
int倍率
(0, ∞)
100
running_status
int运行状态
1-在线
2-离线
[1,2]
1
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_list",
"data": [{
"id": 4,
"device_type": 2,
"ele_meter_id": 10,
"ele_meter": {
"id": 10,
"proto_type": 1,
"proto_id": 1,
"slave_id": 1,
"host": "192.168.77.94",
"port": 1,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"uid": "",
"station_name": "测试站点",
"name": "test",
"ele_device_type_id": 1,
"ele_device_type": {
"id": 1,
"name": "Acrel-ADW300"
},
"running_status": 2,
"direction": 1,
"pt": 1,
"ct": 1,
"purpose": 1,
"meter_ids": null,
"associate_meters": null
},
"devices": [
{
"uid": "",
"name": "设备208",
"site_name": "测试站点",
"location": "",
"longitude": 0,
"latitude": 0,
"statistics_port": 1504,
"cooling_method": 1,
"level": 1,
"charges": null,
"pcs_reboot": 0,
"bms_reboot": 0,
"license": "00000011",
"type": "Linux",
"running_status": 1,
"id": 3,
"proto_type": 1,
"proto_id": 0,
"slave_id": 1,
"host": "192.168.77.208",
"port": 1502,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"created_at": "2024-04-24T02:11:01.16135116Z",
"updated_at": "2024-06-07T07:32:32.1991944Z"
},
{
"uid": "",
"name": "设备210",
"site_name": "测试站点",
"location": "",
"longitude": 0,
"latitude": 0,
"statistics_port": 1504,
"cooling_method": 1,
"level": 1,
"charges": null,
"pcs_reboot": 1,
"bms_reboot": 0,
"license": "",
"type": "",
"running_status": 1,
"id": 4,
"proto_type": 1,
"proto_id": 0,
"slave_id": 1,
"host": "192.168.77.210",
"port": 1502,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"created_at": "2024-05-08T02:03:48.4397178Z",
"updated_at": "2024-06-07T07:32:32.2174462Z"
}
],
"over_demand_status": 1,
"over_demand_condition": [
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"current_over_demand_condition": 2000,
"dynamic_demand_status": 1,
"dynamic_demand": 0,
"dynamic_demand_percentage": 60,
"streaming_status": 1,
"streaming_condition": 2000,
"individual_phase_streaming_status": 2,
"individual_phase_streaming_condition": 100,
"created_at": "2024-06-06T08:59:20.21309056Z",
"updated_at": "2024-06-06T08:59:20.21309056Z",
"updated_by": "user: 1-admin"
}],
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}平台请求同步防逆流过需策略
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/sync/command平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/sync/command
权限：发布
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
reply
UUID所回复消息的mid
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_sync
streaming_overdemand_sync
code
int响应代码
-
见响应代码
msg
str失败原因
-
参数错误
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
响应代码
错误码描述说明200下发成功
400参数有误
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "streaming_overdemand_sync",
"code": 200,
"msg": "",
"device_uid": "iYRkfVpi77",
"timestamp": 1695265671000
}同步防逆流过需电策略响应
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/sync/result平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/sync/result
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_sync
streaming_overdemand_sync
data
[]StreamingOverDemand消息内容
-
见Payload - StreamingOverDemand
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_sync",
"data": [{
"id": 4,
"ele_meter_id": 10,
"ele_meter": {
"id": 10,
"proto_type": 1,
"proto_id": 1,
"slave_id": 1,
"host": "192.168.77.94",
"port": 1,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"uid": "",
"station_name": "测试站点",
"name": "test",
"ele_device_type_id": 1,
"ele_device_type": {
"id": 1,
"name": "Acrel-ADW300"
},
"running_status": 2,
"direction": 1,
"pt": 1,
"ct": 1,
"purpose": 1,
"meter_ids": null,
"associate_meters": null
},
"devices": [
{
"uid": "",
"name": "设备208",
"site_name": "测试站点",
"location": "",
"longitude": 0,
"latitude": 0,
"statistics_port": 1504,
"cooling_method": 1,
"level": 1,
"charges": null,
"pcs_reboot": 0,
"bms_reboot": 0,
"license": "00000011",
"type": "Linux",
"running_status": 1,
"id": 3,
"proto_type": 1,
"proto_id": 0,
"slave_id": 1,
"host": "192.168.77.208",
"port": 1502,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"created_at": "2024-04-24T02:11:01.16135116Z",
"updated_at": "2024-06-07T07:32:32.1991944Z"
},
{
"uid": "",
"name": "设备210",
"site_name": "测试站点",
"location": "",
"longitude": 0,
"latitude": 0,
"statistics_port": 1504,
"cooling_method": 1,
"level": 1,
"charges": null,
"pcs_reboot": 1,
"bms_reboot": 0,
"license": "",
"type": "",
"running_status": 1,
"id": 4,
"proto_type": 1,
"proto_id": 0,
"slave_id": 1,
"host": "192.168.77.210",
"port": 1502,
"com_addr": "",
"com_no": 0,
"baud_rate": 0,
"data_bits": 0,
"stop_bits": 0,
"parity": "",
"created_at": "2024-05-08T02:03:48.4397178Z",
"updated_at": "2024-06-07T07:32:32.2174462Z"
}
],
"over_demand_status": 1,
"over_demand_condition": [
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"current_over_demand_condition": 2000,
"dynamic_demand_status": 1,
"dynamic_demand": 0,
"dynamic_demand_percentage": 60,
"streaming_status": 1,
"streaming_condition": 2000,
"created_at": "2024-06-06T08:59:20.21309056Z",
"updated_at": "2024-06-06T08:59:20.21309056Z",
"updated_by": "user: 1-admin"
}],
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}下发创建防逆流过需电策略指令
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/create/command平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/create/command
权限：发布
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_create
streaming_overdemand_create
data
StreamingOverDemand消息内容
-
见Payload - StreamingOverDemand
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_create",
"data": {
"over_demand_status": 1,
"streaming_status": 1,
"dynamic_demand_status": 1,
"over_demand_condition": [
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"ele_meter_id": 9,
"dynamic_demand_percentage": 80,
"streaming_condition": 1000,
"individual_phase_streaming_status": 2,
"individual_phase_streaming_condition": 100,
},
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}创建防过需防逆流策略响应
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/create/result平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/create/result
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
reply
UUID所回复消息的mid
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_create
streaming_overdemand_create
code
int响应代码
-
见响应代码
data
dataData
见Data
msg
str失败原因
-
参数错误
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Data
参数类型说明id
int
防过需逆流策略id
响应代码
错误码描述说明200下发成功
400参数有误
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "streaming_overdemand_create",
"reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
"code": 200,
"data": {
"id": 1
},
"msg": "",
"device_uid": "iYRkfVpi77",
"timestamp": 1695265671000
}下发更新防逆流过需电策略指令
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/update/command平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/update/command
权限：发布
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_update
streaming_overdemand_update
data
StreamingOverDemand消息内容
-
见Payload - StreamingOverDemand
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_update",
"data": {
"id": 1,
"over_demand_status": 1,
"streaming_status": 1,
"dynamic_demand_status": 1,
"over_demand_condition": [
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"ele_meter_id": 9,
"dynamic_demand_percentage": 80,
"streaming_condition": 1000,
"individual_phase_streaming_status": 2,
"individual_phase_streaming_condition": 100,
},
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}更新防过需防逆流策略响应
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/update/result平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/update/result
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
reply
UUID所回复消息的mid
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_update
streaming_overdemand_update
code
int响应代码
-
见响应代码
msg
str失败原因
-
参数错误
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
响应代码
错误码描述说明200下发成功
400参数有误
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "streaming_overdemand_update",
"reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
"code": 200,
"msg": "",
"device_uid": "iYRkfVpi77",
"timestamp": 1695265671000
}下发删除防逆流过需电策略指令
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/delete/command平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/delete/command
权限：发布
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_delete
streaming_overdemand_delete
data
data消息内容
-
见Payload - data
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload - Data
参数类型是否必填描述样例id
int
是
防过需防逆流策略ID
1
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_delete",
"data": {
"id": 1,
},
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}删除防过需防逆流策略响应
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/delete/result平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/delete/result
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
reply
UUID所回复消息的mid
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_delete
streaming_overdemand_delete
code
int响应代码
-
见响应代码
msg
str失败原因
-
参数错误
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
响应代码
错误码描述说明200下发成功
400参数有误
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "streaming_overdemand_delete",
"reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
"code": 200,
"msg": "",
"device_uid": "iYRkfVpi77",
"timestamp": 1695265671000
}批量下发创建防逆流过需电策略指令
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/update_all/command平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/update_all/command
权限：发布
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_update_all
streaming_overdemand_update_all
data
[]StreamingOverDemand消息内容
-
见Payload - StreamingOverDemand
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "streaming_overdemand_update_all",
"data": [
{
"device_type": 2,
"over_demand_status": 1,
"streaming_status": 1,
"dynamic_demand_status": 1,
"over_demand_condition": [
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"ele_meter_id": 9,
"dynamic_demand_percentage": 80,
"streaming_condition": 1000,
"individual_phase_streaming_status": 2,
"individual_phase_streaming_condition": 100,
}
],
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}批量创建防过需防逆流策略响应
Topic：
用户自定义MQTT：
v1/wudun/${PRODUCT_KEY}/${DEVICE}/streaming_overdemand/update_all/result平台默认MQTT：
v1/user/${TENANT}/${DEVICE}/streaming_overdemand/update_all/result
权限：订阅
Payload主结构
参数类型是否必填描述范围样例mid
UUID消息ID
-
4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
reply
UUID所回复消息的mid
-
3e681859-6917-4b9a-9afd-3f162cd185bd
type
str消息类型
streaming_overdemand_update_all
streaming_overdemand_update_all
code
int响应代码
-
见响应代码
msg
str失败原因
-
参数错误
device_uid
str（二级）设备UID
-
iYRkfVpi77
timestamp
int消息时间戳（单位：毫秒）
(0, ∞)
1696837112000
响应代码
错误码描述说明200下发成功
400参数有误
Payload示例
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "streaming_overdemand_update_all",
"reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
"code": 200,
"msg": "",
"device_uid": "iYRkfVpi77",
"timestamp": 1695265671000
}最后更新于