oneapi
Autentificare
Energie v1 / Balanţe energetice

Resursele de energie primară

Din ce se alcătuiesc resursele de energie primară ale ţării — 2.739 de valori, anual
1992-2024, pe 14 categorii de resurse şi patru provenienţe: producţie internă, import, stocul
de la începutul anului şi totalul lor (IND107A).

⚠️ Fiecare resursă are unitatea ei fizică, plus mii tep. Cărbunele e în mii tone, gazele în
milioane m³, energia electrică în milioane kWh — dar toate cele 14 categorii sunt publicate şi în
mii tone echivalent petrol, singura unitate în care se pot compara între ele. um face parte
din identitatea seriei.

⚠️ total ar trebui să fie producţie + import + stoc iniţial, şi aproape întotdeauna este.
Verificat pe toate cele 823 de perechi resursă × unitate × an: 808 se închid la 0,5%. Din cele
15 rămase, 14 au totalul PESTE componentele publicate — o componentă nu e publicată, nu e o
contradicţie — iar una îl are sub. Deci total se citeşte de la sursă, nu se recompune.

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

Parametri de interogare

NumeTipDescriereValori acceptate
provenientaopțional string | null total, productie, import ori stoc_initial. totalproductieimportstoc_initial
resursaopțional string | null Slugul unei resurse primare din nomenclator. Fără el, vin toate. ex. gaze_naturale
umopțional string | null Unitatea. mii_tone_echivalent_petrol e singura comună tuturor resurselor. ex. mii_tone_echivalent_petrol
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ă

  • Din ce se alcătuiesc resursele de energie primară ale ţării — 2.739 de valori, anual 1992-2024, pe 14 categorii de resurse şi patru provenienţe: producţie internă, import, stocul de la începutul anului şi totalul lor (matricea TEMPO IND107A).
  • Fiecare resursă are unitatea ei fizică, plus mii tep. Cărbunele e în mii tone, gazele în milioane m³, energia electrică în milioane kWh — dar toate cele 14 categorii sunt publicate şi în mii tone echivalent petrol, singura unitate în care se pot compara între ele. um face parte din identitatea seriei, nu e o etichetă.
  • total se citeşte de la sursă, nu se recompune. Ar trebui să fie producţie + import + stoc iniţial, şi aproape întotdeauna este: verificat pe toate cele 823 de perechi resursă × unitate × an, 808 se închid la 0,5%. Din cele 15 rămase, 14 au totalul peste componentele publicate — o componentă pur şi simplu nu e publicată, nu e o contradicţie — iar una îl are sub.

La ce folosește

  • Vezi cât din energia primară a ţării vine din producţie internă şi cât din import.
  • Urmăreşti pe treizeci de ani cum s-a schimbat mixul de resurse primare.
  • Compari resurse între ele — dar numai în mii tep, singura unitate comună.

Structura răspunsului

CâmpTipDescriere
data.serii[].resursa string Slugul resursei.
data.serii[].provenienta string Producţie, import, stoc iniţial ori totalul lor.
data.serii[].um string Unitatea — parte din identitatea seriei.
data.serii[].ani_publicati integer Câţi ani au valoare din intervalul cerut; restul sunt null, nu zero.
data.serii[].valori object An → valoare, ca text zecimal.
data.ani array Anii acoperiţi de răspuns.
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.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.
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.nota_unitati string Avertismentul despre unități amestecate, repetat lângă date.
data.serii[].resursa_denumire string Denumirea resursei.
meta.nota_unitati string De ce nu se pot aduna serii cu unități diferite.
meta.nota_total string Care rânduri sunt totaluri și de ce nu se adună peste celelalte.
meta.nota_sen string Relația cu datele în timp real din zona sen: alt concept, altă sursă, nu se compară direct.
meta.nota_lista string Cum se obține lista completă a codurilor: din /energie/v1/balante/nomenclator.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/resurse?resursa=gaze_naturale&um=mii_tone_echivalent_petrol
{
    "data": {
        "nota_unitati": "Fiecare resursă e publicată în unitatea ei fizică ŞI în mii tep. Doar `mii_tone_echivalent_petrol` acoperă toate categoriile şi permite comparaţia între ele.",
        "granularitate": "anual",
        "de_la": 1992,
        "pana_la": 2024,
        "filtre": {
            "resursa": "gaze_naturale",
            "um": "mii_tone_echivalent_petrol"
        },
        "ani": [
            1992,
            1993,
            1994,
            1995,
            1996,
            1997,
            1998,
            1999,
            2000,
            2001,
            2002,
            2003,
            2004,
            2005,
            2006,
            2007,
            2008,
            2009,
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "resursa": "gaze_naturale",
                "resursa_denumire": "Gaze naturale",
                "provenienta": "import",
                "um": "mii_tone_echivalent_petrol",
                "um_denumire": "Mii tone echivalent petrol",
                "ani_publicati": 33,
                "valori": {
                    "1992": "3582",
                    "1993": "3616",
                    "1994": "3735",
                    "1995": "4794",
                    "1996": "5654",
                    "1997": "4030",
                    "1998": "3773",
                    "1999": "2538",
                    "2000": "2712",
                    "2001": "2332",
                    "2002": "3043",
                    "2003": "4723",
                    "2004": "4127",
                    "2005": "4233",
                    "2006": "4839",
                    "2007": "3904",
                    "2008": "3567",
                    "2009": "1614",
                    "2010": "1834",
                    "2011": "2489",
                    "2012": "2321",
                    "2013": "1177",
                    "2014": "470",
                    "2015": "163",
                    "2016": "1188",
                    "2017": "962",
                    "2018": "1220",
                    "2019": "2158",
                    "2020": "1726",
                    "2021": "2869",
                    "2022": "2294",
                    "2023": "2151",
                    "2024": "1852"
                }
            }
        ]
    },
    "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": 4,
        "nota_unitati": "⚠️ Fiecare resursă e publicată în unitatea ei fizică ŞI în mii tep. Doar `mii_tone_echivalent_petrol` acoperă toate categoriile şi permite comparaţia între ele.",
        "nota_total": "⚠️ `total` se citeşte de la sursă, nu se recompune din componente: în 15 din 823 de perechi suma componentelor publicate nu-l reface, aproape mereu fiindcă o componentă lipseşte.",
        "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.
404necunoscutResursa nu apare în nomenclator.
404in_afara_acopeririiIntervalul cerut e în întregime în afara anilor publicaţi.
422raspuns_prea_marePeste 20.000 de celule — restrânge perioada ori seriile.
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 — restrânge perioada ori seriile.",
        "detalii": {
            "provenienta": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}