保护策略

获取、更新、删除设备保护策略

创建保护策略

• Method：POST

• URL：https://www.einfra.cn/wad/ems/v1/api/protection-strategy

• 接口描述：为特定ems设备创建保护策略，每个设备最多一条策略

• 请求

  • Body参数/protectionStrategy

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx
    streaming	streaming		防逆流	-	-
    overdemand	overdemand		防过需	-	-
    charge_depth	chargeDepth		放电深度保护	-	-
    safety	safety		安全保护	-	-

  • streaming

    参数	类型	是否必填	描述	范围	样例
    status	int		策略开关	0-关闭 1-开启	1
    total_margin	int		总安全余量（单位：kW）	[0,65535]	1000
    margin_a	int		A相独立安全余量（单位：kW）	[0,65535]	400
    margin_b	int		B相独立安全余量（单位：kW）	[0,65535]	400
    margin_b	int		C相独立安全余量（单位：kW）	[0,65535]	400

  • overdemand

    参数	类型	是否必填	描述	范围	样例
    status	int		策略开关	0-关闭1-开启	1
    total_demand	int		总最大需量（单位：kW）	[0,65535]	1000
    demand_a	int		A相独立最大需量（单位：kW）	[0,65535]	400
    demand_b	int		B相独立最大需量（单位：kW）	[0,65535]	400
    demand_c	int		C相独立最大需量（单位：kW）	[0,65535]	400

  • chargeDepth

    参数	类型	是否必填	描述	范围	样例
    charge_depth	int		充电保护深度SOC（单位：%）	[0,100]	70
    charge_slow	int		开始减缓充电SOC（单位：%）	[0,100]	80
    charge_max_vol	int		单体最高电压末端控制（单位：V）	[0,65535]	300
    charge_pcs	int		开始减缓充电PCS输出（单位：%）	[0,100]	50
    discharge_depth	int		放电保护深度SOC（单位：%）	[0,100]	100
    discharge_slow	int		开始减缓放电SOC（单位：%）	[0,100]	80
    discharge_min_vol	int		单体最低电压末端控制（单位：V）	[0,65535]	200
    discharge_pcs	int		开始减缓放电PCS输出（单位：%）	[0,100]	50

  • safety

    参数	类型	是否必填	描述	范围	样例
    bms_3	int		BMS三级报警停机开关	0-关闭 1-开启	1
    bms_2	int		BMS二级报警降功率开关	0-关闭 1-开启	1
    bms_2_kw	int		BMS二级报警降功率开关（单位：kW）	[0,65535]	400
    aircon	int		空调掉线停机开关	0-关闭 1-开启	1
    aircon_mins	int		空调掉线持续时间（单位：min）	[0,65535]	5
    temp	int		室内温度过高停机开关	0-关闭 1-开启	1
    temp_celsius	int		室内温度过高值（单位：℃）	[0,65535]	50
    grounded	int		接地离线停机开关	0-关闭 1-开启	1
    grounded_mins	int		接地离线持续时间（单位：min）	[0,65535]	5
    fire_control	int		消防报警停机开关	0-关闭 1-开启	1
    flooding	int		水浸报警停机开关	0-关闭 1-开启	1
    meter_offline_power0	int		负荷电表离线功率为0开关	0-关闭 1-开启	1
    meter_offline_mins	int		负荷电表离线持续时间（单位：min）	[0,65535]	5

  • 示例

cURL

Python

Java

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	策略创建成功

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

获取保护策略

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/protection-strategy

• 接口描述：获取充放电策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx
    page-size	int		每页设备数量（默认值为50）	[0, ∞]	50
    page	int		页码（默认值 1）	[0, ∞]	1

  • 示例

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		错误描述	-	-
    data	listResult		每页设备数量（默认值为50）	-	50

  • listResult

    参数	类型	是否必填	描述	范围	样例
    total	int		总策略数	[0, ∞]	10
    list	[]protectionStrategy		策略列表	-	-

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

修改策略

• Method：PATCH

• URL：https://www.einfra.cn/wad/ems/v1/api/protection-strategy

• 接口描述：根据设备及索引修改策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx

  • Body参数/protectionStrategy

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	策略更新成功

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

同步保护策略

• Method：PUT

• URL：https://www.einfra.cn/wad/ems/v1/api/protection-strategy/sync

• 接口描述：同步保护策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	策略更新成功
    data	listResult		同步后的保护策略列表