atess-server-openapi
  1. OpenAPI-HPS
atess-server-openapi
  • Record
  • 1. the first step Authorization
  • 2.the seccond step add Plant
  • 3.the third step add DataLog
  • OpenAPI-BMS
    • Get base info of BCU
      GET
    • Get base info of BCU list
      GET
    • Get historical data of BCU
      GET
    • Get the latest real-time data of BCU
      GET
    • Get setting of BUC
      GET
    • Modify setting of BCU
      PUT
    • Get base info of MBMS
      GET
    • Get base info of MBMS list
      GET
    • Get historical data of MBMS
      GET
    • Get the latest real-time data of MBMS
      GET
    • Get setting of MBMS
      GET
    • Modify setting of MBMS
      PUT
  • OpenAPI-DataLog
    • Get DataLog
    • Add DataLog
    • Delete DataLog
    • Get DataLog list
  • OpenAPI-HPS
    • Get Central type base info of HPS
      GET
    • Get Central type base info of HPS list
      GET
    • Get historical data of Central type HPS
      GET
    • Get the latest real-time data of Central type HPS
      GET
    • Get setting of Central type HPS
      GET
    • Modify setting of Central type HPS
      PUT
    • Get String type base info of HPS
      GET
    • Get String type base info of HPS list
      GET
    • Get historical data of String type HPS
      GET
    • Get the latest real-time data of String type HPS
      GET
    • Get setting of String type HPS
      GET
    • Modify setting of String type HPS
      PUT
  • OpenAPI-PBD
    • Get base info of PBD
    • Get base info of PBD list
    • Get historical data of PBD
    • Get the latest real-time data of PBD
    • Get setting of PBD
    • Modify setting of PBD
  • OpenAPI-PCS
    • Get base info of PCS
    • Get base info of PCS list
    • Get historical data of PCS
    • Get the latest real-time data of PCS
    • Get setting of PCS
    • Modify setting of PCS
  • OpenAPI-Plant
    • Get the basic information of the power station
    • Add power station
    • Modify the basic information of the power station
    • Delete power station
    • Get a list of power stations
  1. OpenAPI-HPS

Get setting of Central type HPS

Prod Env
https://www.enerclo-atesspower.com
Prod Env
https://www.enerclo-atesspower.com
GET
https://www.enerclo-atesspower.com
/api/v1/hps/big-setting
OpenAPI-HPS

Limit the frequency#

The device supports 10 reads per day

Request Header#

HeaderValueDescription
Authorization############ your token ############Permission validation
Accept-LanguageenEnglish Message

Request Param#

Method : GET
KeyValue Type
deviceSnString
https://www.enerclo-atesspower.com/api/v1/hps/big-setting?deviceSn=1

Response Body#

{
    "code": 0,
    "data": {
        "atsComNo": 0,
......        
        "valleyPeriodTime5": "string"
    },
    "msg": "operate successfully"
}
code: value 200 is a success, anything else is an exception
data: result data
msg: result message,code=200 is usually empty
codedescription
200succeed
500fail
400not fount
403No access
...Other exceptions

Response Data Description#

The corresponding field in the interface return value, if not specified, indicates that the field exists in all devices of the model. The parameters corresponding to special models are explained as follows.

HPS100HV,HPS150HV models additional parameters#

parameterdevice typedesc
sharedBatteryEnableHPS100HV/HPS150HVNot supported
cpEnableHPS100HV/HPS150HVNot supported
cpNominalPowerHPS100HV/HPS150HVNot supported

Request

Query Params
deviceSn
string 
required
deviceSn
Header Params
Authorization
string 
required
Token
CompanyType
string 
optional
客制化
Accept-Language
string 
required
Default:
en

Responses

🟢200OK
*/*
OK
Body
code
integer <int32>
optional
code
data
object (OpenApiCentralTypeHpsSettingVo) 
optional
atsComNo
integer <int32>
optional
ATS Com No. (0~255)
>= 0<= 255
atsComNoEnable
enum<integer> <int32>
optional
ATS Com No.Enable (0: Disable;1: Enable)
Allowed values:
01
atsUnitsNum
integer <int32>
optional
ATS units (0~10)
>= 0<= 10
batCapacity
integer <int32>
optional
Battery Capacity (0~50000 AH)
>= 0<= 50000
batCellsNum
integer <int32>
optional
No.of Battery Cells (0~50000)
>= 0<= 50000
batOcChargeProtect
number <float>
optional
BAT OC Charge Protect (0~10000(0.1A))
>= 0<= 1000
batOcDischargeProtect
number <float>
optional
BAT OC Discharge Protect (0~10000(0.1A))
>= 0<= 1000
batOverVoltProtect
number <float>
optional
BAT OverVolt Protect (0~50000(0.001V))
>= 0<= 50
batRacksNum
integer <int32>
optional
No.of Battery Racks (0~100)
>= 0<= 100
batSaturation
integer <int32>
optional
BAT Saturation (0~10)
>= 0<= 10
batToNonCriticalEnable
enum<integer> <int32>
optional
BAT to Non-Critical Enable (0: Disable;1: Enable)
Allowed values:
01
batUnderVoltProtect
number <float>
optional
BAT UnderVolt Protect (0~50000(0.001V) 针对每个电池单元)
>= 0<= 50
batUnderVoltWarn
number <float>
optional
BAT UnderVolt Warning (0~50000(0.001V) 针对每个电池单元)
>= 0<= 50
bmsEnable
enum<integer> <int32>
optional
BMS Com Enable (0: Disable;1: Enable)
Allowed values:
01
bmsVoltJudgeSwitch
enum<integer> <int32>
optional
BMS Volt Judge Switch (0: Disable;1: Enable)
Allowed values:
01
bypassEnable
enum<integer> <int32>
optional
ATS Enable (0: Disable;1: Enable)
Allowed values:
01
checkTime
string 
optional
Check Time (0~1000S)
>= 0 characters<= 1000 characters
cpEnable
integer <int32>
optional
PSG Enable
>= 0<= 2
cpNominalPower
integer <int32>
optional
PSG Nominal Power
>= 0<= 500
cutOffVolt
number <float>
optional
Cut-off Voltage (0~50000 针对每个电池单元(0.001V))
>= 0<= 50
deviceLowPeakTimeSettingVo
object (OpenApiDeviceLowPeakTimeSettingVo) 
optional
exportLimit
enum<integer> <int32>
optional
Zero Export Enable (0: Disable;1: Enable)
Allowed values:
01
floatVolt
number <float>
optional
Float Voltage (0~50000(0.001V) 针对每个电池单元)
>= 0<= 50
floatingLimitSet
number <float>
optional
Floating Limit Set (0~100针对每个电池单元(0.01V))
>= 0<= 1
gridChargePower
number <float>
optional
Grid Charge Power (0.1KW According to the model power limit)
gridPvEnable
enum<integer> <int32>
optional
Grid & PV Charge Enable (0: Disable;1: Enable)
Allowed values:
01
icharge
integer <int32>
optional
BAT Charge Current (0~800 1A)
>= 0<= 800
masterSlaveFlag
integer <int32>
optional
Parallel Address
>= 0<= 255
maxExportToGrid
integer <int32>
optional
Max.Export to Grid (0~500kW)
>= 0<= 500
maxGenChargePower
number <float>
optional
Max.GEN Charge Power (0.1KW According to the model power limit)
maxGenPower
integer <int32>
optional
Max.GEN Power (0~500KW
>= 0<= 500
maxGridPower
integer <int32>
optional
Max.Import from Grid (0~500Kw)
>= 0<= 500
meterComNo
integer <int32>
optional
Meter Com No. (0~255)
>= 0<= 255
meterCtRatio
integer <int32>
optional
Meter CT ratio (0~65535)
>= 0<= 65535
midPeakPowerSet1
integer <int32>
optional
Mid-peak Power Set1
>= 0<= 500
midPeakPowerSet2
integer <int32>
optional
Mid-peak Power Set2
>= 0<= 500
midPeakPowerSet3
integer <int32>
optional
Mid-peak Power Set3
>= 0<= 500
midPeakPowerSet4
integer <int32>
optional
Mid-peak Power Set4
>= 0<= 500
midPeakPowerSet5
integer <int32>
optional
Mid-peak Power Set5
>= 0<= 500
modelSelect
integer <int32>
optional
Mode
>= 0<= 12
offPeakPowerSet1
integer <int32>
optional
Off-peak Power Set1
>= 0<= 500
offPeakPowerSet2
integer <int32>
optional
Off-peak Power Set2
>= 0<= 500
offPeakPowerSet3
integer <int32>
optional
Off-peak Power Set3
>= 0<= 500
offPeakPowerSet4
integer <int32>
optional
Off-peak Power Set4
>= 0<= 500
offPeakPowerSet5
integer <int32>
optional
Off-peak Power Set5
>= 0<= 500
oilMachineEnable
enum<integer> <int32>
optional
DG Enable (0: Disable;1: Enable)
Allowed values:
01
onOff
enum<integer> <int32>
optional
ON/OFF (0: Off;1: On)
Allowed values:
01
onPeakPowerSet1
integer <int32>
optional
On-peak Power Set1 (0~500Kw)
>= 0<= 500
onPeakPowerSet2
integer <int32>
optional
On-peak Power Set2 (0~500Kw)
>= 0<= 500
onPeakPowerSet3
integer <int32>
optional
On-peak Power Set3 (0~500Kw)
>= 0<= 500
onPeakPowerSet4
integer <int32>
optional
On-peak Power Set4 (0~500Kw)
>= 0<= 500
onPeakPowerSet5
integer <int32>
optional
On-peak Power Set5 (0~500Kw)
>= 0<= 500
parallelAddressAutoSwitch
enum<integer> <int32>
optional
Parallel Address Auto Switch (0: Disable;1: Enable)
Allowed values:
01
parallelEnable
enum<integer> <int32>
optional
Parallel Enable (0: Disable;1: Enable)
Allowed values:
01
parallelRedundant
enum<integer> <int32>
optional
Parallel Redundant
Allowed values:
01
parallelUnitNum
integer <int32>
optional
Number of parallel units
>= 0<= 255
peakPeriodTime1
string 
optional
On-peak time1 (HH:mm-HH:mm)
peakPeriodTime2
string 
optional
On-peak time2 (HH:mm-HH:mm)
peakPeriodTime3
string 
optional
On-peak time3 (HH:mm-HH:mm)
peakPeriodTime4
string 
optional
On-peak time4 (HH:mm-HH:mm)
peakPeriodTime5
string 
optional
On-peak time5 (HH:mm-HH:mm)
pvChargeToOffGrid
number <float>
optional
PV Charge to Off-Grid (0~50000 针对每个电池单元(0.001V))
>= 0<= 50
regularPeriodTime1
string 
optional
Mid-peak time1 (HH:mm-HH:mm)
regularPeriodTime2
string 
optional
Mid-peak time2 (HH:mm-HH:mm)
regularPeriodTime3
string 
optional
Mid-peak time3 (HH:mm-HH:mm)
regularPeriodTime4
string 
optional
Mid-peak time4 (HH:mm-HH:mm)
regularPeriodTime5
string 
optional
Mid-peak time5 (HH:mm-HH:mm)
sharedBatteryEnable
enum<integer> <int32>
optional
Battery Share Enable
Allowed values:
01
socChargeCutOff
integer <int32>
optional
Charge Cut-off SOC (0-100%)
>= 0<= 100
socDischargeCutOff
integer <int32>
optional
Discharge Cut-off SOC (0-100%)
>= 0<= 100
socOff
integer <int32>
optional
GEN Off SOC (0~100%)
>= 0<= 100
socOn
integer <int32>
optional
GEN On SOC (0~100%)
>= 0<= 100
socReDischarge
integer <int32>
optional
Re-discharge SOC (0-100%)
>= 0<= 100
station485
integer <int32>
optional
485 Station (0~65535 bps)
>= 0<= 65535
systemNo
integer <int32>
optional
System ID sign (0~100 )
>= 0<= 100
trickleChargeSet
number <float>
optional
Trickle charge Set (0~500(0.1KW))
>= 0<= 50
valleyPeriodTime1
string 
optional
Off-peak time1 (HH:mm-HH:mm)
valleyPeriodTime2
string 
optional
Off-peak time2 (HH:mm-HH:mm)
valleyPeriodTime3
string 
optional
Off-peak time3 (HH:mm-HH:mm)
valleyPeriodTime4
string 
optional
Off-peak time4 (HH:mm-HH:mm)
valleyPeriodTime5
string 
optional
Off-peak time5 (HH:mm-HH:mm)
msg
string 
optional
message
Example
{
    "code": 0,
    "data": {
        "atsComNo": 0,
        "atsComNoEnable": 0,
        "atsUnitsNum": 0,
        "batCapacity": 0,
        "batCellsNum": 0,
        "batOcChargeProtect": 0,
        "batOcDischargeProtect": 0,
        "batOverVoltProtect": 0,
        "batRacksNum": 0,
        "batSaturation": 0,
        "batToNonCriticalEnable": 0,
        "batUnderVoltProtect": 0,
        "batUnderVoltWarn": 0,
        "bmsEnable": 0,
        "bmsVoltJudgeSwitch": 0,
        "bypassEnable": 0,
        "checkTime": "string",
        "cpEnable": 0,
        "cpNominalPower": 0,
        "cutOffVolt": 0,
        "deviceLowPeakTimeSettingVo": {
            "offSeasonSaturdayMidPeak1": "string",
            "offSeasonSaturdayMidPeak2": "string",
            "offSeasonSaturdayMidPeak3": "string",
            "offSeasonSaturdayMidPeak4": "string",
            "offSeasonSaturdayMidPeak5": "string",
            "offSeasonSaturdayOffPeak1": "string",
            "offSeasonSaturdayOffPeak2": "string",
            "offSeasonSaturdayOffPeak3": "string",
            "offSeasonSaturdayOffPeak4": "string",
            "offSeasonSaturdayOffPeak5": "string",
            "offSeasonSaturdayOnPeak1": "string",
            "offSeasonSaturdayOnPeak2": "string",
            "offSeasonSaturdayOnPeak3": "string",
            "offSeasonSaturdayOnPeak4": "string",
            "offSeasonSaturdayOnPeak5": "string",
            "offSeasonSundayMidPeak1": "string",
            "offSeasonSundayMidPeak2": "string",
            "offSeasonSundayMidPeak3": "string",
            "offSeasonSundayMidPeak4": "string",
            "offSeasonSundayMidPeak5": "string",
            "offSeasonSundayOffPeak1": "string",
            "offSeasonSundayOffPeak2": "string",
            "offSeasonSundayOffPeak3": "string",
            "offSeasonSundayOffPeak4": "string",
            "offSeasonSundayOffPeak5": "string",
            "offSeasonSundayOnPeak1": "string",
            "offSeasonSundayOnPeak2": "string",
            "offSeasonSundayOnPeak3": "string",
            "offSeasonSundayOnPeak4": "string",
            "offSeasonSundayOnPeak5": "string",
            "offSeasonTime1": "string",
            "offSeasonTime2": "string",
            "offSeasonTime3": "string",
            "offSeasonTime4": "string",
            "offSeasonWorkMidPeak1": "string",
            "offSeasonWorkMidPeak2": "string",
            "offSeasonWorkMidPeak3": "string",
            "offSeasonWorkMidPeak4": "string",
            "offSeasonWorkMidPeak5": "string",
            "offSeasonWorkOffPeak1": "string",
            "offSeasonWorkOffPeak2": "string",
            "offSeasonWorkOffPeak3": "string",
            "offSeasonWorkOffPeak4": "string",
            "offSeasonWorkOffPeak5": "string",
            "offSeasonWorkOnPeak1": "string",
            "offSeasonWorkOnPeak2": "string",
            "offSeasonWorkOnPeak3": "string",
            "offSeasonWorkOnPeak4": "string",
            "offSeasonWorkOnPeak5": "string",
            "peakSeasonSaturdayMidPeak1": "string",
            "peakSeasonSaturdayMidPeak2": "string",
            "peakSeasonSaturdayMidPeak3": "string",
            "peakSeasonSaturdayMidPeak4": "string",
            "peakSeasonSaturdayMidPeak5": "string",
            "peakSeasonSaturdayOffPeak1": "string",
            "peakSeasonSaturdayOffPeak2": "string",
            "peakSeasonSaturdayOffPeak3": "string",
            "peakSeasonSaturdayOffPeak4": "string",
            "peakSeasonSaturdayOffPeak5": "string",
            "peakSeasonSaturdayOnPeak1": "string",
            "peakSeasonSaturdayOnPeak2": "string",
            "peakSeasonSaturdayOnPeak3": "string",
            "peakSeasonSaturdayOnPeak4": "string",
            "peakSeasonSaturdayOnPeak5": "string",
            "peakSeasonSundayMidPeak1": "string",
            "peakSeasonSundayMidPeak2": "string",
            "peakSeasonSundayMidPeak3": "string",
            "peakSeasonSundayMidPeak4": "string",
            "peakSeasonSundayMidPeak5": "string",
            "peakSeasonSundayOffPeak1": "string",
            "peakSeasonSundayOffPeak2": "string",
            "peakSeasonSundayOffPeak3": "string",
            "peakSeasonSundayOffPeak4": "string",
            "peakSeasonSundayOffPeak5": "string",
            "peakSeasonSundayOnPeak1": "string",
            "peakSeasonSundayOnPeak2": "string",
            "peakSeasonSundayOnPeak3": "string",
            "peakSeasonSundayOnPeak4": "string",
            "peakSeasonSundayOnPeak5": "string",
            "peakSeasonTime1": "string",
            "peakSeasonTime2": "string",
            "peakSeasonTime3": "string",
            "peakSeasonTime4": "string",
            "peakSeasonWorkMidPeak1": "string",
            "peakSeasonWorkMidPeak2": "string",
            "peakSeasonWorkMidPeak3": "string",
            "peakSeasonWorkMidPeak4": "string",
            "peakSeasonWorkMidPeak5": "string",
            "peakSeasonWorkOffPeak1": "string",
            "peakSeasonWorkOffPeak2": "string",
            "peakSeasonWorkOffPeak3": "string",
            "peakSeasonWorkOffPeak4": "string",
            "peakSeasonWorkOffPeak5": "string",
            "peakSeasonWorkOnPeak1": "string",
            "peakSeasonWorkOnPeak2": "string",
            "peakSeasonWorkOnPeak3": "string",
            "peakSeasonWorkOnPeak4": "string",
            "peakSeasonWorkOnPeak5": "string"
        },
        "exportLimit": 0,
        "floatVolt": 0,
        "floatingLimitSet": 0,
        "gridChargePower": 0,
        "gridPvEnable": 0,
        "icharge": 0,
        "masterSlaveFlag": 0,
        "maxExportToGrid": 0,
        "maxGenChargePower": 0,
        "maxGenPower": 0,
        "maxGridPower": 0,
        "meterComNo": 0,
        "meterCtRatio": 0,
        "midPeakPowerSet1": 0,
        "midPeakPowerSet2": 0,
        "midPeakPowerSet3": 0,
        "midPeakPowerSet4": 0,
        "midPeakPowerSet5": 0,
        "modelSelect": 0,
        "offPeakPowerSet1": 0,
        "offPeakPowerSet2": 0,
        "offPeakPowerSet3": 0,
        "offPeakPowerSet4": 0,
        "offPeakPowerSet5": 0,
        "oilMachineEnable": 0,
        "onOff": 0,
        "onPeakPowerSet1": 0,
        "onPeakPowerSet2": 0,
        "onPeakPowerSet3": 0,
        "onPeakPowerSet4": 0,
        "onPeakPowerSet5": 0,
        "parallelAddressAutoSwitch": 0,
        "parallelEnable": 0,
        "parallelRedundant": 0,
        "parallelUnitNum": 0,
        "peakPeriodTime1": "string",
        "peakPeriodTime2": "string",
        "peakPeriodTime3": "string",
        "peakPeriodTime4": "string",
        "peakPeriodTime5": "string",
        "pvChargeToOffGrid": 0,
        "regularPeriodTime1": "string",
        "regularPeriodTime2": "string",
        "regularPeriodTime3": "string",
        "regularPeriodTime4": "string",
        "regularPeriodTime5": "string",
        "sharedBatteryEnable": 0,
        "socChargeCutOff": 0,
        "socDischargeCutOff": 0,
        "socOff": 0,
        "socOn": 0,
        "socReDischarge": 0,
        "station485": 0,
        "systemNo": 0,
        "trickleChargeSet": 0,
        "valleyPeriodTime1": "string",
        "valleyPeriodTime2": "string",
        "valleyPeriodTime3": "string",
        "valleyPeriodTime4": "string",
        "valleyPeriodTime5": "string"
    },
    "msg": "string"
}
Previous
Get the latest real-time data of Central type HPS
Next
Modify setting of Central type HPS
Built with