电压治理

下发电压治理控制

• Method：POST

• URL：https://www.einfra.cn/wad/ems/v1/api/voltage-control

• 接口描述：为特定ems设备下发电压治理控制指令

• 请求

  • Body参数/voltageControl

  参数	类型	是否必填	描述	范围	样例
  device_uid	string		设备唯一ID	-	xxxxx
  phase_rated_voltage_a	int		A相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_rated_voltage_b	int		B相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_rated_voltage_c	int		C相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_voltage_upper_limit_threshold_a	int		A相电压上限阈值,A相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_upper_limit_threshold_b	int		B相电压上限阈值,B相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_upper_limit_threshold_c	int		C相电压上限阈值,C相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_lower_limit_threshold_a	int		A相电压上限阈值,A相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_lower_limit_threshold_b	int		B相电压上限阈值,B相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_lower_limit_threshold_c	int		C相电压上限阈值,C相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_hysteresis_a	int		A相电压回差,触发调节后,A相平均电压达到回差值时,停止调节		5
  phase_voltage_hysteresis_b	int		B相电压回差,触发调节后,B相平均电压达到回差值时,停止调节		5
  phase_voltage_hysteresis_c	int		C相电压回差,触发调节后,C相平均电压达到回差值时,停止调节		5
  period	int		调节周期,单位毫秒	-	500
  step	int		步长,每次调节的步长	-	5

  • 响应

    • 数据类型：application/json

      参数	类型	是否必填	描述	范围	样例
      code	int		错误码	见下文错误码	0
      message	str		描述	-	PCS控制下发成功
      data	str		详细信息

  • 错误码

    HTTP状态码	错误码	描述
    200	0	成功
    400	100001	参数格式错误

获取电压治理控制

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/voltage-control

• 接口描述：获取电压治理控制

• 请求

  • Query参数

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

• 响应

  • application

  参数	类型	是否必填	描述	范围	样例
  code	int		错误码	见下文错误码	0
  message	str		描述	-
  data	object		同步后的控制

  • data：

  参数	类型	是否必填	描述	范围	样例
  device_uid	string		设备唯一ID	-	xxxxx
  phase_rated_voltage_a	int		A相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_rated_voltage_b	int		B相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_rated_voltage_c	int		C相额定电压,希望A相保持的电压（单位：V）	-	220
  phase_voltage_upper_limit_threshold_a	int		A相电压上限阈值,A相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_upper_limit_threshold_b	int		B相电压上限阈值,B相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_upper_limit_threshold_c	int		C相电压上限阈值,C相平均电压高于该阈值则触发调节策略（单位：V）	-	240
  phase_voltage_lower_limit_threshold_a	int		A相电压上限阈值,A相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_lower_limit_threshold_b	int		B相电压上限阈值,B相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_lower_limit_threshold_c	int		C相电压上限阈值,C相平均电压低于该阈值则触发调节策略（单位：V）	-	200
  phase_voltage_hysteresis_a	int		A相电压回差,触发调节后,A相平均电压达到回差值时,停止调节		5
  phase_voltage_hysteresis_b	int		B相电压回差,触发调节后,B相平均电压达到回差值时,停止调节		5
  phase_voltage_hysteresis_c	int		C相电压回差,触发调节后,C相平均电压达到回差值时,停止调节		5
  period	int		调节周期,单位毫秒	-	500
  step	int		步长,每次调节的步长	-	5

同步电压治理控制

• Method：PUT

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

• 接口描述： 同步电压治理控制

• 请求

  • Query参数

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

• 响应

  • application

参数	类型	是否必填	描述	范围	样例
code	int		错误码	见下文错误码	0
message	str		描述	-	电压治理同步成功
data	object		同步后的控制

• data：

参数	类型	是否必填	描述	范围	样例
device_uid	string		设备唯一ID	-	xxxxx
phase_rated_voltage_a	int		A相额定电压,希望A相保持的电压（单位：V）	-	220
phase_rated_voltage_b	int		B相额定电压,希望A相保持的电压（单位：V）	-	220
phase_rated_voltage_c	int		C相额定电压,希望A相保持的电压（单位：V）	-	220
phase_voltage_upper_limit_threshold_a	int		A相电压上限阈值,A相平均电压高于该阈值则触发调节策略（单位：V）	-	240
phase_voltage_upper_limit_threshold_b	int		B相电压上限阈值,B相平均电压高于该阈值则触发调节策略（单位：V）	-	240
phase_voltage_upper_limit_threshold_c	int		C相电压上限阈值,C相平均电压高于该阈值则触发调节策略（单位：V）	-	240
phase_voltage_lower_limit_threshold_a	int		A相电压上限阈值,A相平均电压低于该阈值则触发调节策略（单位：V）	-	200
phase_voltage_lower_limit_threshold_b	int		B相电压上限阈值,B相平均电压低于该阈值则触发调节策略（单位：V）	-	200
phase_voltage_lower_limit_threshold_c	int		C相电压上限阈值,C相平均电压低于该阈值则触发调节策略（单位：V）	-	200
phase_voltage_hysteresis_a	int		A相电压回差,触发调节后,A相平均电压达到回差值时,停止调节		5
phase_voltage_hysteresis_b	int		B相电压回差,触发调节后,B相平均电压达到回差值时,停止调节		5
phase_voltage_hysteresis_c	int		C相电压回差,触发调节后,C相平均电压达到回差值时,停止调节		5
period	int		调节周期,单位毫秒	-	500
step	int		步长,每次调节的步长	-	5