【未上线】二级保护策略

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

创建防逆流策略

• Method：POST

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

• 接口描述：为特定二级ems设备创建防逆流策略

• 请求

  • Body参数/streaming

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一ID	-	xxxxx
    elec_meter_ids	[]int		电表设备ID列表	-	xxxxx
    status	int		策略开关	0-关闭 1-开启	1
    baseline	int		逆流触发基线（单位：kW）	[0,65535]	1000

• 响应

  • 数据类型：application/json

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

• 错误码

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

获取防逆流策略

• Method：GET

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

• 接口描述：获取防逆流策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一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	[]streamingWithID		策略列表	-	-

  • streamingWithID

    参数	类型	是否必填	描述	范围	样例
    id	int		策略ID	[1, ∞]	10
    其他字段同streaming

• 错误码

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

修改防逆流策略

• Method：PATCH

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

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

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一ID	-	xxxxx
    strategy_id	int		策略ID	[1, ∞]	10

  • Body参数/streaming

• 响应

  • 数据类型：application/json

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

• 错误码

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

创建防过需策略

• Method：POST

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

• 接口描述：为特定二级ems设备创建防过需策略

• 请求

  • Body参数/overdemand

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一ID	-	xxxxx
    elec_meter_ids	[]int		电表设备ID列表	-	xxxxx
    status	int		策略开关	0-关闭 1-开启	1
    baseline	int		过需触发基线（单位：kW）	[0,65535]	1000

• 响应

  • 数据类型：application/json

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

• 错误码

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

获取防过需策略

• Method：GET

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

• 接口描述：获取防过需策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一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	[]overdemandWithID		策略列表	-	-

  • overdemandWithID

    参数	类型	是否必填	描述	范围	样例
    id	int		策略ID	[1, ∞]	10
    其他字段同overdemand

• 错误码

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

修改防过需策略

• Method：PATCH

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

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

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		二级EMS设备唯一ID	-	xxxxx
    strategy_id	int		策略ID	[1, ∞]	10

  • Body参数/streaming

• 响应

  • 数据类型：application/json

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

• 错误码

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