Inverters

Get a list of the inverters in the plant with the data of the current time.

You can enter a range of dates to get the data for that period.

/v1//inverters//?start=XXX&end=XXX

Arguments

  • plant [*]: Name of the plant where the inverters are located.
  • id_inverter: (Optional) ID inverter. If you enter the id of an inverter only show the data of that inverter.
  • start: (Optional) (yyyy-mm-dd hh:ii:ss) Start date of search interval.
    If you only enter the start date it will show the reading of that moment.
  • end: (Optional) (yyyy-mm-dd hh:ii:ss) End date of search interval.
    Can not be greater than the current date or the difference
    between dates can not be greater than 32 days

Response

JSON object with the result. May return the following errors:

  • 404 Not found : No device found or don't have rights to get data
  • 400 Wrong inverter id: The id format is incorrect
  • 400 Bad Dates: Dates entered are incorrect
  • 204 No data found: The data entered have not produced any results

Example

Get all inverters data (last quarter) in DonBenito plant

GET /v1/DonBenito/inverters/ HTTP/1.1
Host: apiexternal.mvscada.com
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Content-Type: application/json

Response

json
{
"id_inverter": "all",
"start": "2017-04-10 17:15:00",
"plant": "DonBenito",
"end": "",
"inverters": [
{
"IT_ac": 4.89,
"V1_dc": 67.45,
"datetime": "2017-04-10 17:15:00",
"id": "inv001",
"IR_ac": 4.88,
"cosfi": null,
"V3_dc": 68.14,
"Preac_ac": null,
"Pact_ac": 3.46398,
"energia": 0.818,
"I2_dc": 19.38,
"plant": "DonBenito",
"VT_ac": 231.96,
"VS_ac": 233.92,
"Papar_ac": null,
"T1": null,
"I3_dc": 18.39,
"freq": null,
"pot_inst_dc": 3.79281,
"VR_ac": 233.78,
"alarma": null,
"I1_dc": 18.38,
"IS_ac": 5.09,
"V2_dc": 67.14
},
{
"IT_ac": 4.95,
"V1_dc": 67.35,
"datetime": "2017-04-10 17:15:00",
...
"V2_dc": 66.89
},
{...}
]
}

Other examples

Get the last data of all inverters on the plant 'DonBenito2'

/v1/DonBenito2/inverters/

Get all datas of all inverters between requested dates

/v1/DonBenito2/inverters/?start=2017-03-30 08:00:00&end=2017-03-31 08:00:00

Get the data of the requested inverter in the requested date

/v1/DonBenito2/inverters/inv230/?start=2017-03-30 08:00:00

Get all datas of the requested inverter between requested dates

/v1/DonBenito2/inverters/inv230/?start=2017-03-30 08:00:00&end=2017-03-31 08:00:00