Limit the frequency

The frequency of acquisition is once every 5 minutes

Request Header

Header	Value	Description
Authorization	############ your token ############	Permission validation
Accept-Language	en	English Message

Request Param

Method : GET

https://www.enerclo-atesspower.com/api/v1/pcs/data-list?deviceSn=xxxxxxxxxx&startDate=2023-10-01 00:00:00&endDate=2023-10-01 23:59:59&pageNo=1&pageSize=10

Response Body

{
    "code": 0,
    "data": {
        "datas": [
            {
                "atsBypass": 0,
......
                "vpvwu": 0
            }
        ],
        "offset": 0,
        "pageNo": 0,
        "pageSize": 0,
        "total": 0
    },
    "msg": "string"
}

code: value 200 is a success, anything else is an exception
data: result data
msg: result message，code=200 is usually empty

code	description
200	succeed
500	fail
400	not fount
403	No 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.

PCS whose dtc is 215xx models additional parameters

parameter	device type	desc
runModel	DTC:215XX	4:Back-up Mode;5:Standard Mode
rtfPower	DTC:215XX	RTF Power(kW)
rtfDemandPower	DTC:215XX	RTF Demand(kW)
rtfState	DTC:215XX	RTF State
rtfPowerLimit	DTC:215XX	RTF Power Limit(kW)

Request

Query Params

deviceSn

string

required

Example:

ZVD0D30232

startDate

string

required

Start Date

Example:

2023-11-10 00:00:00

endDate

string

required

End Date

Example:

2023-11-10 23:59:59

pageNo

integer

required

Page No

Example:

pageSize

integer

required

Page Size

Example:

Header Params

Authorization

string

required

Accept-Language

string

required

Default:

Responses

🟢200OK

application/json

Body

code

integer <int32>

optional

code

data

object (Pager«OpenApiPcsDataVo»)

optional

datas

array[object (OpenApiPcsDataVo) {115}]

optional

offset

integer <int32>

optional

pageNo

integer <int32>

optional

pageSize

integer <int32>

optional

total

integer <int64>

optional

msg

string

optional

message

Example

{
    "code": 0,
    "data": {
        "datas": [
            {
                "atsBypass": 0,
                "bactivePower": 0,
                "bapparentPower": 0,
                "bmsStatus": 0,
                "bmsSystemStatus": 0,
                "bmsVoltStatus": 0,
                "breactivePower": 0,
                "bvbus": 0,
                "bypassFreq": 0,
                "capacity": 0,
                "checkTime": 0,
                "cpActivePower": 0,
                "cpPowerLimit": 0,
                "cpcu": 0,
                "cpcv": 0,
                "cpcw": 0,
                "dailyPowerGridInverter": 0,
                "deviceSn": "string",
                "dgActivePower": 0,
                "dgApparentPower": 0,
                "dgCurrentU": 0,
                "dgCurrentV": 0,
                "dgCurrentW": 0,
                "dgGridSelect": 0,
                "dgReactivePower": 0,
                "dgTodayIntakePower": 0,
                "dgTodayIntakeTime": 0,
                "dgTotalIntakePower": 0,
                "dgTotalIntakeTime": 0,
                "dryContactState": 0,
                "ebatChargeTimeTotal": 0,
                "ebatChargeTotal": 0,
                "ebatDischargeTimeTotal": 0,
                "ebatDischargeTotal": 0,
                "echargeTimeToday": 0,
                "echargeToday": 0,
                "edischargeTimeToday": 0,
                "edischargeToday": 0,
                "egridTimeToday": 0,
                "egridTimeTotal": 0,
                "egridToday": 0,
                "egridTotal": 0,
                "eloadTimeToday": 0,
                "eloadTimeTotal": 0,
                "eloadToday": 0,
                "eloadTotal": 0,
                "epvTimeToday": 0,
                "epvTimeTotal": 0,
                "epvToday": 0,
                "epvTotal": 0,
                "etoGridTimeToday": 0,
                "etoGridTimeTotal": 0,
                "etoGridToday": 0,
                "etoGridTotal": 0,
                "fac": 0,
                "gvpvuv": 0,
                "gvpvvw": 0,
                "gvpvwu": 0,
                "ibat": 0,
                "ipva": 0,
                "ipvb": 0,
                "ipvc": 0,
                "ipvu": 0,
                "ipvv": 0,
                "ipvw": 0,
                "loadActivePower": 0,
                "loadApparentPower": 0,
                "loadIu": 0,
                "loadIv": 0,
                "loadIw": 0,
                "loadPf": 0,
                "loadReactivePower": 0,
                "maxChargeCurr": 0,
                "maxDischargeCurr": 0,
                "maxTemp": 0,
                "maxTempGroup": 0,
                "maxTempNum": 0,
                "maxVolt": 0,
                "maxVoltCell": 0,
                "maxVoltGroup": 0,
                "maxVoltNum": 0,
                "minTemp": 0,
                "minTempGroup": 0,
                "minTempNum": 0,
                "minVolt": 0,
                "minVoltCell": 0,
                "minVoltGroup": 0,
                "minVoltNum": 0,
                "mvpv": 0,
                "outActivePower": 0,
                "outApparentPower": 0,
                "outReactivePower": 0,
                "outvu": 0,
                "outvv": 0,
                "outvw": 0,
                "pac": 0,
                "pbdOutputPower": 0,
                "pcsDcPower": 0,
                "pf": 0,
                "runModel": 0,
                "status": 0,
                "sysBatteryCurr": 0,
                "systemNo": 0,
                "temp": 0,
                "temp1": 0,
                "temp4": 0,
                "time": "string",
                "totalPowerGridInverter": 0,
                "vacu": 0,
                "vacv": 0,
                "vacw": 0,
                "vbat": 0,
                "vpvuv": 0,
                "vpvvw": 0,
                "vpvwu": 0
            }
        ],
        "offset": 0,
        "pageNo": 0,
        "pageSize": 0,
        "total": 0
    },
    "msg": "string"
}

Get historical data of PCS

Limit the frequency#

Request Header#

Request Param#

Response Body#

Response Data Description#

PCS whose dtc is 215xx models additional parameters#

Request

Responses

Limit the frequency

Request Header

Request Param

Response Body

Response Data Description

PCS whose dtc is 215xx models additional parameters