oneapi
Autentificare
Energie v1 / Balanţe energetice

Gradul de independenţă energetică

Cât din consumul intern brut e acoperit din producţia internă, pe patru produse energetice —
cărbune, ţiţei, gaze naturale şi totalul. 132 de valori, anual 1992-2024 (IND121A).

⚠️ E un raport, în procente: nu se adună între produse şi nu se mediază fără ponderi.
Totalul e publicat de sursă, nu compus din cele trei.

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

Parametri de interogare

NumeTipDescriereValori acceptate
produsopțional string | null Slugul unui produs energetic din nomenclator. ex. titei
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ă

  • Cât din consumul intern brut e acoperit din producţia internă, pe patru produse energetice — cărbune, ţiţei, gaze naturale şi totalul. 132 de valori, anual 1992-2024 (IND121A).
  • E un raport, în procente: nu se adună între produse şi nu se mediază fără ponderi. Totalul e publicat de sursă, nu compus din cele trei.

La ce folosește

  • Măsori dependenţa de import pe cărbune, ţiţei şi gaze, separat.
  • Urmăreşti pe treizeci de ani cum s-a schimbat autonomia energetică a ţării.

Structura răspunsului

CâmpTipDescriere
data.serii[].produs string Slugul produsului energetic.
data.serii[].nivel string total ori produs.
data.serii[].valori object An → procent, 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 array 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.unitate string Unitatea în care e exprimat raportul de independență energetică.
data.serii[].produs_denumire string Denumirea produsului.
meta.nota_raport string Cum se citește raportul: cât din consum e acoperit din producție internă.
meta.nota_sen string Relația cu datele în timp real din zona sen.
meta.nota_lista string Unde se găsesc codurile de produs.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/independenta?de_la=2010
{
    "data": {
        "unitate": "procente — cât din consumul intern brut e acoperit din producţia internă",
        "granularitate": "anual",
        "de_la": 2010,
        "pana_la": 2024,
        "filtre": [],
        "ani": [
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019,
            2020,
            2021,
            2022,
            2023,
            2024
        ],
        "serii": [
            {
                "produs": "carbune_inclusiv_cocs",
                "produs_denumire": "Carbune (inclusiv cocs)",
                "nivel": "produs",
                "um_denumire": "Procente",
                "ani_publicati": 15,
                "valori": {
                    "2010": "85.4",
                    "2011": "81.8",
                    "2012": "84",
                    "2013": "81.9",
                    "2014": "77.8",
                    "2015": "80.4",
                    "2016": "80.3",
                    "2017": "83.1",
                    "2018": "79",
                    "2019": "79.7",
                    "2020": "73.9",
                    "2021": "73.8",
                    "2022": "78.6",
                    "2023": "86.3",
                    "2024": "86.9"
                }
            }
        ]
    },
    "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_raport": "⚠️ E un raport în procente — nu se adună între produse şi nu se mediază fără ponderi. Totalul e publicat de sursă.",
        "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.
404necunoscutProdusul nu apare în nomenclator.
404in_afara_acopeririiIntervalul cerut e în afara anilor publicaţi.
422validareUn parametru nu a trecut validarea (produs, de_la, pana_la); detalii spune care şi de ce.
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": "validare",
        "mesaj": "Un parametru nu a trecut validarea (produs, de_la, pana_la); detalii spune care şi de ce.",
        "detalii": {
            "produs": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}