oneapi
Autentificare
Energie v1 / Balanţe energetice

Centralele electrice: putere şi producţie

Cele şase categorii de centrale — termo, hidro, nuclear, eoliană, solară şi totalul lor — cu
puterea instalată la sfârşitul anului (mii kW) şi energia produsă în cursul lui
(milioane kWh). 318 valori, anual 1992-2024 (IND114A, IND118A).

⚠️ Cele două măsuri nu se împart una la alta fără grijă. Puterea instalată e un stoc la 31
decembrie, producţia e un flux peste tot anul: un grup pus în funcţiune în noiembrie intră întreg
în putere şi aproape deloc în producţie. Factorul de utilizare calculat naiv iese fals de mic în
anii cu punere în funcţiune.

⚠️ Total e rând publicat de sursă, nu suma noastră. nivel îl marchează, ca să nu fie
adunat peste categorii.

GET
https://oneapi.ro/api/energie/v1/balante/centrale

Parametri de interogare

NumeTipDescriereValori acceptate
masuraopțional string | null productie (implicit) ori putere_instalata. putere_instalataproductie
categorieopțional string | null Slugul unei categorii de centrale din nomenclator. ex. eoliana
de_laopțional string | null Primul an inclus, din 1992. ex. 2010
pana_laopțional string | null Ultimul an inclus. ex. 2024

Cum se comportă

  • Cele şase categorii de centrale — termo, hidro, nuclear, eoliană, solară şi totalul lor — cu puterea instalată la sfârşitul anului (mii kW) şi energia produsă în cursul lui (milioane kWh). 318 valori, anual 1992-2024 (IND114A, IND118A).
  • Cele două măsuri nu se împart una la alta fără grijă. Puterea instalată e un stoc la 31 decembrie, producţia e un flux peste tot anul: un grup pus în funcţiune în noiembrie intră întreg în putere şi aproape deloc în producţie. Factorul de utilizare calculat naiv iese fals de mic tocmai în anii cu puneri în funcţiune.
  • Total e rând publicat de sursă, nu suma noastră. nivel îl marchează, ca să nu fie adunat peste categorii.
  • Aici, spre deosebire de combustibili, totalul chiar e suma categoriilor: verificat pe toate cele 33 de ani şi pe amândouă măsurile, abaterea maximă e de 1 mie kW, adică rotunjire. Rămâne totuşi rândul sursei, nu al nostru.

La ce folosește

  • Urmăreşti cum a crescut puterea instalată eoliană şi solară după 2010.
  • Compari producţia hidro de la un an la altul, ca măsură a hidraulicităţii.
  • Vezi ponderea nuclearului în producţia totală, an de an.

Structura răspunsului

CâmpTipDescriere
data.masura string productie ori putere_instalata.
data.serii[].categorie string Slugul categoriei de centrale.
data.serii[].nivel string total ori categorie — totalul nu se adună peste categorii.
data.serii[].um_denumire string Unitatea, după măsură: mii kW ori milioane kWh.
data.serii[].valori object An → valoare, ca text zecimal.
data.granularitate string Pasul seriei. La balanțe e mereu anual: INS publică bilanțul o dată pe an.
data.de_la integer Primul an din răspuns.
data.pana_la integer Ultimul an din răspuns.
data.filtre object Filtrele efectiv aplicate, ca să se vadă ce a fost interpretat din cerere.
data.ani array Anii acoperiți, în ordine — cheile din valori.
data.serii[].um Codul unității de măsură.
data.serii[].ani_publicati integer Câți ani au valoare efectivă. Diferența față de lungimea lui ani sunt găurile din publicarea INS.
meta.sursa string Setul INS din care vine seria, cu matricea de origine.
meta.acoperire object Intervalul de ani disponibil în bază pentru zona asta, indiferent de filtrul cerut.
meta.serii_returnate integer Câte serii sunt în răspuns.
data.descriere_masura string Ce înseamnă măsura aleasă.
data.serii[].categorie_denumire string Denumirea categoriei.
meta.nota_masuri string Ce măsuri există și cum diferă între ele.
meta.nota_total string Care rânduri sunt totaluri.
meta.nota_sen string Relația cu datele în timp real din zona sen.
meta.nota_lista string Unde se găsesc codurile de categorie.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/centrale?masura=putere_instalata&de_la=2010
{
    "data": {
        "masura": "putere_instalata",
        "descriere_masura": "puterea instalată a grupurilor, la sfârşitul anului, în mii kW",
        "granularitate": "anual",
        "de_la": 2010,
        "pana_la": 2024,
        "filtre": {
            "masura": "putere_instalata"
        },
        "ani": [
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "categorie": "eoliana",
                "categorie_denumire": "Eoliana",
                "nivel": "categorie",
                "um_denumire": "Mii kilowatti",
                "ani_publicati": 15,
                "valori": {
                    "2010": "389",
                    "2011": "988",
                    "2012": "1822",
                    "2013": "2773",
                    "2014": "3244",
                    "2015": "3130",
                    "2016": "3025",
                    "2017": "3030",
                    "2018": "3032",
                    "2019": "3037",
                    "2020": "3013",
                    "2021": "3015",
                    "2022": "3015",
                    "2023": "3027",
                    "2024": "3096"
                }
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — balanţele energetice (TEMPO, matricile IND107A-IND121A).",
        "acoperire": {
            "de_la": "1992-01-01",
            "pana_la": "2024-01-01"
        },
        "serii_returnate": 6,
        "nota_masuri": "⚠️ Puterea instalată e un stoc la 31 decembrie, producţia un flux peste tot anul. Împărţite naiv, dau un factor de utilizare fals de mic în anii cu puneri în funcţiune.",
        "nota_total": "`Total` e rând publicat de sursă, marcat prin `nivel` — nu se adună peste categorii.",
        "nota_sen": "Sunt date statistice anuale. Starea instantanee a sistemului, de la Transelectrica, e la /energie/v1/sen — altă natură, nu se compară.",
        "nota_lista": "Nomenclatoarele zonei: /energie/v1/balante/nomenclator."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404necunoscutCategoria nu apare în nomenclator.
404in_afara_acopeririiIntervalul cerut e în afara anilor publicaţi.
422raspuns_prea_marePeste 20.000 de celule.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "raspuns_prea_mare",
        "mesaj": "Peste 20.000 de celule.",
        "detalii": {
            "masura": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}