无功治理

下发无功治理控制

• Method：POST

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

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

• 请求

  • Body参数/reactivePowerControl

  参数	类型	是否必填	描述	范围	样例
  device_uid	string		设备唯一ID	-	xxxxx
  phase_min_power_factor_a	float		A相最低功率因数	[0,1]	0.8
  phase_min_power_factor_b	float		B相最低功率因数	[0,1]	0.8
  phase_min_power_factor_c	float		C相最低功率因数	[0,1]	0.8
  phase_power_factor_hysteresis_a	float		A相功率因数回差	[0,1]	0.05
  phase_power_factor_hysteresis_b	float		B相功率因数回差	[0,1]	0.05
  phase_power_factor_hysteresis_c	float		C相功率因数回差	[0,1]	0.05
  period	int		调节周期,单位毫秒	-	500
  step	float		步长,每次调节的步长	-	0.1
  mode	int		无功补偿模式	1-容性无功补偿 Capacitive 2-感性无功补偿 Inductive	1

  • 响应

    • 数据类型：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/reactive-power-control

• 接口描述：获取无功治理控制

• 请求

  • Query参数

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

• 响应

  • application

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

  • data：

  参数	类型	是否必填	描述	范围	样例
  device_uid	string		设备唯一ID	-	xxxxx
  phase_min_power_factor_a	float		A相最低功率因数	[0,1]	0.8
  phase_min_power_factor_b	float		B相最低功率因数	[0,1]	0.8
  phase_min_power_factor_c	float		C相最低功率因数	[0,1]	0.8
  phase_power_factor_hysteresis_a	float		A相功率因数回差	[0,1]	0.05
  phase_power_factor_hysteresis_b	float		B相功率因数回差	[0,1]	0.05
  phase_power_factor_hysteresis_c	float		C相功率因数回差	[0,1]	0.05
  period	float		调节周期,单位毫秒	-	500
  step	float		步长,每次调节的步长	-	0.1
  mode	int		无功补偿模式	1-容性无功补偿 Capacitive 2-感性无功补偿 Inductive	1

同步无功治理控制

• Method：PUT

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

• 接口描述： 同步无功治理控制

• 请求

  • Query参数

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

• 响应

  • application

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

• data：

参数	类型	是否必填	描述	范围	样例
device_uid	string		设备唯一ID	-	xxxxx
phase_min_power_factor_a	float		A相最低功率因数	[0,1]	0.8
phase_min_power_factor_b	float		B相最低功率因数	[0,1]	0.8
phase_min_power_factor_c	float		C相最低功率因数	[0,1]	0.8
phase_power_factor_hysteresis_a	float		A相功率因数回差	[0,1]	0.05
phase_power_factor_hysteresis_b	float		B相功率因数回差	[0,1]	0.05
phase_power_factor_hysteresis_c	float		C相功率因数回差	[0,1]	0.05
period	float		调节周期,单位毫秒	-	500
step	float		步长,每次调节的步长	-	0.1
mode	int		无功补偿模式	1-容性无功补偿 Capacitive 2-感性无功补偿 Inductive	1