充放电策略

[一级EMU] 获取、更新、删除设备充放电策略

创建充放电策略

• Method：POST

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

• 接口描述：为特定ems设备创建充放电策略，每个设备最多四条充放电策略

• 请求

  • Body参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx
    charge_type	int		充放电类型（后续将支持更多类型）	1-定时充放电	1
    status	int		策略开关	0-关闭, 1-开启	1
    month	[]int		月份选择（0代表一月）	[0,11]	[1,7,8,11]
    week_day	[]int		星期选择（0代表星期一）	[0,6]	[5,6]
    settings	[]chargeTime		充放电时间段，支持1到12个		-

  • chargeTime

    参数	类型	是否必填	描述	范围	样例
    start_hour	int		开始小时	[0,23]	20
    start_minute	int		开始分钟	[0,59]	0
    end_hour	int		结束小时	[0,23]	23
    end_minute	int		结束分钟	[0,59]	0
    cdc_enable_mode	int		充放电设定	0-待机, 1-充电, 2-放电	1
    run_power	int		运行功率(单位：kW)	[0,65535]	300

  • 示例

cURL

Python

Java

• 响应

  • 数据类型：application/json

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

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误
  400	140002	mqtt超时
  400	140003	不是设备的拥有者，操作权限不足
  400	140004	规则创建失败
  400	140005	规则更新失败
  400	140006	规则列表获取失败
  400	140007	策略数量超出限制
  400	140008	该设备ID对应的ems设备未找到

获取充放电策略

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/charge-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	[]chargeStrategy		策略列表	-	-

  • chargeStrategy

    参数	类型	是否必填	描述	范围	样例
    charge_id	int		策略ID	[0, ∞]	1
    device_uid	str		设备唯一ID	-	xxxxx
    index	int		策略在设侧的索引	[0,3]	2
    charge_type	int		充放电类型（后续将支持更多类型）	1-定时充放电	1
    status	int		策略开关	0-关闭, 1-开启	1
    month	[]int		月份选择（0代表一月）	[0,11]	[1,7,8,11]
    week_day	[]int		星期选择（0代表星期一）	[0,6]	[5,6]
    settings	[]chargeTime		充放电时间段	-	-

• 错误码

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

根据策略ID修改策略

• Method：PATCH

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

• 接口描述：根据策略ID修改策略

• 请求

  • 路径参数

    参数	类型	是否必填	描述	范围	样例
    :id	int		策略ID	[0, ∞]	1

  • Body参数

    参数	类型	是否必填	描述	范围	样例
    charge_type	int		充放电类型（后续将支持更多类型）	1-定时充放电	1
    status	int		策略开关	0-关闭, 1-开启	1
    month	[]int		月份选择（0代表一月）	[0,11]	[1,7,8,11]
    week_day	[]int		星期选择（0代表星期一）	[0,6]	[5,6]
    settings	[]chargeTime		充放电时间段	-	-

• 响应

  • 数据类型：application/json

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

• 错误码

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

根据设备及索引修改策略

• Method：PATCH

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

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

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx
    index	int		策略在设侧的索引	[0,3]	2

  • Body参数

    参数	类型	是否必填	描述	范围	样例
    charge_type	int		充放电类型（后续将支持更多类型）	1-定时充放电	1
    status	int		策略开关	0-关闭, 1-开启	1
    month	[]int		月份选择（0代表一月）	[0,11]	[1,7,8,11]
    week_day	[]int		星期选择（0代表星期一）	[0,6]	[5,6]
    settings	[]chargeTime		充放电时间段	-	-

• 响应

  • 数据类型：application/json

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

• 错误码

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

同步充放电策略

• Method：PUT

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

• 接口描述： 同步充放电策略

• 请求

  • Query参数

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

• 响应

  • 数据类型：application/json

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