Hydric

[GET] https://api.terna.it/generation/v2.0/hydric

link

Authorization OAuth 2.0

Request Header

API field	Type	Description	Format	Card	Example
businessID	string			0..1
Authorization	string	OAuth Token		1..1	Bearer <token>
Accept	string			0..1	Application/Json

Query Params

API field	Type	Description	Format	Card	Example
region	string	Region to be extracted		0..1	Abruzzo
province	string	Provinces to be extracted		0..n	Chieti
productionType	string	Production type to be extracted		0..1	Lorda
hydricPlant	string	Water system to be extracted		0..1	Bacino
year	string	Year to be extracted	integer	1..1	2022

Production Type List

Production type is to be chosen as an element of the set [ 'Lorda', 'Netta']

Hydric plant List

Hydric plant is to be chosen as an element of the set [ 'Bacino', 'Fluente', 'Serbatoio' ]

IMPORTANT NOTE : when the value entered does not match one of the expected values, an error will not be returned, but an empty body will be returned.

Response Structure 200

API field	Type	Description	Format	Card	Example
result	Obj	Result		1..1	"result":{..}
.message	string			1..1	"OK"
.status	string			1..1	"Completed"
hydric	array			0..n	"hydric":[{..}]
.year	string		integer	1..1	"2023"
.production_type	string			1..1	"Lorda"
.region	string			1..1	"Abruzzo"
.province	string			1..1	"Chieti"
.hydric_plant	string			1..1	"Bacino"
.production_GWh	string		number	1..1	"199,301"

Example

cURL Request

curl --location --request GET https://api.terna.it/generation/v2.0/hydric?year=<year>®ion=<region>&province=<province>&productionType=<productionType> 
        --header 'Authorization:Bearer <OAuth Token>'

Response


{
    "result": {
        "message": "string",
        "status": "string"
    },
    "hydric": [
        {
          "year": "string",
          "production_type": "string",
          "region": "string",
          "province": "string",
          "hydric_system": "string",
          "production_GWh": "string"
        }
    ]
}

version 3 as of 3 weeks ago by Alisia Barrovecchio