oneapi
Autentificare
Energie v1 / Balanţe energetice

Combustibilii pentru energie termoelectrică

Ce se arde pentru energia termoelectrică: structura pe combustibili (procente) şi consumul
specific de combustibil (kg echivalent petrol). 330 de valori, anual 1992-2024 (IND116A,
IND120A).

⚠️ Lignit e „din care" din Carbuni, nu un combustibil alături de el. Publicat doar în
2014 şi 2015 — 38,7% şi 40,1%, faţă de 46,0% şi 45,0% la cărbuni — deci e conţinut în ei.
Însumat cu ceilalţi, s-ar număra de două ori. nivel îl marchează drept din_care.

⚠️ Golul dintre total şi componente se lărgeşte în timp. Total, din care: e 100% prin
construcţie, dar componentele publicate acopereau 98,6% în 1992 şi doar 62,2% în 2023 — azi
peste o treime din producţia termoelectrică stă pe combustibili pe care sursa nu-i mai desface.

⚠️ La consum_specific, totalul nu e suma componentelor, ci o medie ponderată — 213,8 kg ep
în 2024, faţă de 775,8 cât dau componentele adunate. Doar structura se comportă ca o descompunere.

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

Parametri de interogare

NumeTipDescriereValori acceptate
masuraopțional string | null structura (implicit, procente) ori consum_specific (kg echivalent petrol). consum_specificstructura
combustibilopțional string | null Slugul unui combustibil din nomenclator. ex. carbuni
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ă

  • Ce se arde pentru energia termoelectrică: structura pe combustibili (procente) şi consumul specific de combustibil (kg echivalent petrol). 330 de valori, anual 1992-2024 (IND116A, IND120A).
  • lignit e „din care" din carbuni, nu un combustibil alături de el. Publicat doar în 2014 şi 2015 — 38,7% şi 40,1%, faţă de 46,0% şi 45,0% la cărbuni — deci e cuprins în ei. Însumat cu ceilalţi, s-ar număra de două ori. nivel=din_care îl marchează.
  • Golul dintre total şi componente se lărgeşte în timp. Total, din care: e 100% prin construcţie, dar componentele publicate acopereau 98,6% din structură în 1992 şi doar 62,2% în 2023. Nu e un procent fix de „nedetaliat", ci o acoperire care se subţiază: azi peste o treime din producţia termoelectrică stă pe combustibili pe care sursa nu-i mai desface.
  • La consum_specific, totalul nu e suma componentelor, ci o medie ponderată — 213,8 kg echivalent petrol în 2024, faţă de 775,8 cât dau componentele adunate. E consumul specific al fiecărui combustibil, deci adunarea lor n-are sens. Doar structura se comportă ca o descompunere.

La ce folosește

  • Vezi cum a scăzut ponderea cărbunelui în producţia termoelectrică.
  • Urmăreşti eficienţa termocentralelor prin consumul specific de combustibil.

Structura răspunsului

CâmpTipDescriere
data.masura string structura ori consum_specific.
data.serii[].combustibil string Slugul combustibilului.
data.serii[].nivel string total, component ori din_care — ultimul e lignitul, cuprins în cărbuni.
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[].um_denumire string Unitatea de măsură scrisă în clar. Citește-o: seriile din același răspuns pot fi în unități diferite, iar adunarea lor n-ar însemna nimic.
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[].combustibil_denumire string Denumirea combustibilului.
meta.nota_lignit string De ce lignitul apare separat de „cărbune" și cum se raportează unul la altul.
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 combustibil.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/combustibili?de_la=2015
{
    "data": {
        "masura": "structura",
        "descriere_masura": "ponderea fiecărui combustibil în producţia termoelectrică, în procente",
        "granularitate": "anual",
        "de_la": 2015,
        "pana_la": 2024,
        "filtre": {
            "masura": "structura"
        },
        "ani": [
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "combustibil": "carbuni",
                "combustibil_denumire": "Carbuni",
                "nivel": "component",
                "um_denumire": "Procente",
                "ani_publicati": 10,
                "valori": {
                    "2015": "45",
                    "2016": "41.6",
                    "2017": "42.1",
                    "2018": "40.4",
                    "2019": "38.8",
                    "2020": "29.7",
                    "2021": "32",
                    "2022": "31.7",
                    "2023": "27.3",
                    "2024": "24.3"
                }
            }
        ]
    },
    "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_lignit": "⚠️ `lignit` e „din care\" din `carbuni`, publicat doar în 2014 şi 2015. `nivel=din_care` îl marchează — însumat cu ceilalţi, s-ar număra de două ori.",
        "nota_total": "⚠️ Componentele publicate acopereau 98,6% din structură în 1992 şi doar 62,2% în 2023 — golul se lărgeşte în timp. Iar la `consum_specific` totalul e o medie ponderată, nu o sumă: 213,8 kg ep în 2024, faţă de 775,8 cât dau componentele adunate.",
        "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.
404necunoscutCombustibilul 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."
            ]
        }
    }
}