Generic

Get a list of the generic (meteos, transformes) 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/<plant>/generic/<id_generic>/?start=XXX&end=XXX

Arguments

  • plant [*]: Name of the plant where the generic are located.
  • id_generic: (Optional) ID generic. If you enter the id of a generic only show the data of that generic.
  • 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 : You do not have access to the required resource or no exits
  • 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 generic data (last quarter) in XXX plant

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

Response

{
    "plant": "******",
    "id_generic": "****",
    "start": "2023-10-16 21:45:00",
    "end": "",
    "generic": [
        {
            "plant": "****",
            "datetime": "2023-10-16 21:45:00",
            "id": "****",
            "alarma": 0,
            "status": "ok",
            "Instantaneous_Wind_Speed": "0.0",
            "Instantaneous_Wind_Direction": "248.81314086914062",
            "Instantaneous_Relative_Humidity": "100.0",
            "Instantaneous_Air_Temperature": "20.18600082397461",
            "Instantaneous_Alb_Incid_Rad": "0.0",
            "Instantaneous_Alb_Reflle_Rad": "0.11448479443788528",
            "Instantaneous_Albedo_Calc": "null",
            "Instantaneous_Net_Rad_Calc": "null",
            "Instantaneous_Alb_Incid_Rad_POA": "0.0",
            "Instantaneous_Alb_Reflle_Rad_POA": "0.0",
            "Instantaneous_Albedo_Calc_POA": "null",
            "Instantaneous_Net_Rad_Calc_POA": "null",
            "Instantaneous_Diffuse_Rad": "0.0",
            "Instantaneous_SEMS_Elevation": "null",
            "Instantaneous_SEMS_Orientation": "null",
            "Instantaneous_Solar_Elevation": "-8.96419906616211",
            "Instantaneous_Clean_Cell_Rad": "0.0",
            "Instantaneous_Dirty_Cell_Rad": "0.0",
            "Instantaneous_Attenuation": "null",
            "Instantaneous_Panel_Temp_1": "17.73358154296875",
            "Instantaneous_Panel_Temp_2": "17.94976806640625",
            "Instantaneous_Rain": "0.0",
            "Instantaneous_Battery_Level": "13.861001014709473",
            "Average_Wind_Speed": "0.0",
            "Average_Wind_Direction": "248.71160888671875",
            "Average_Relative_Humidity": "99.99906158447266",
            "Average_Air_Temperature": "20.28448486328125",
            "Average_Alb_Incid_Rad": "0.003738821716979146",
            "Average_Alb_Reflle_Rad": "0.10887477546930313",
            "Average_Albedo_Calc": "null",
            "Average_Net_Rad_Calc": "null",
            "Average_Alb_Incid_Rad_POA": "0.007523760199546814",
            "Average_Alb_Reflle_Rad_POA": "0.08653070032596588",
            "Average_Albedo_Calc_POA": "null",
            "Average_Net_Rad_Calc_POA": "null",
            "Average_Diffuse_Rad": "0.004626396577805281",
            "Average_SEMS_Elevation": "null",
            "Average_SEMS_Orientation": "null",
            "Average_Solar_Elevation": "-8.964207649230957",
            "Average_Clean_Cell_Rad": "0.0",
            "Average_Dirty_Cell_Rad": "0.0",
            "Average_Attenuation": "null",
            "Average_Panel_Temp_1": "18.191650390625",
            "Average_Panel_Temp_2": "18.380184173583984",
            "Average_Battery_Level": "13.854194641113281",
            "Maximum_Wind_Speed": "0.0",
            "Maximum_Wind_Direction": "251.61358642578125",
            "Maximum_Air_Temperature": "20.530067443847656",
            "Maximum_Alb_Incid_Rad": "0.06371482461690903",
            "Maximum_Alb_Reflle_Rad": "0.2138993740081787",
            "Maximum_Net_Rad_Calc": "null",
            "Maximum_Alb_Incid_Rad_POA": "0.08608672767877579",
            "Maximum_Alb_Reflle_Rad_POA": "0.1911124289035797",
            "Maximum_Net_Rad_Calc_POA": "null",
            "Maximum_Diffuse_Rad": "0.06250171363353729",
            "Maximum_Clean_Cell_Rad": "0.0",
            "Maximum_Dirty_Cell_Rad": "0.0",
            "Maximum_Battery_Level": "13.883000373840332",
            "Minimum_Air_Temperature": "20.133846282958984",
            "Minimum_Albedo_Calc": "null",
            "Minimum_Net_Rad_Calc": "null",
            "Minimum_Albedo_Calc_POA": "null",
            "Minimum_Net_Rad_Calc_POA": "null",
            "Minimum_Battery_Level": "13.834000587463379"
        }
    ]
}

Other examples

Get the last data of all generic on the plant 'XXX'

/v1/XXX/generic/

Get all datas of all generic between requested dates

/v1/XXX/generic/?start=2017-03-30 08:00:00&end=2017-03-31 08:00:00

Get the data of the requested generic in the requested date

/v1/XXX/generic/son001/?start=2017-03-30 08:00:00

Get all datas of the requested generic between requested dates

/v1/XXX/generic/son001/?start=2017-03-30 08:00:00&end=2017-03-31 08:00:00