Energie v1 / Balanţe energetice

Nomenclatorul balanţelor energetice

Toate nomenclatoarele zonei într-un singur răspuns — resurse cu unităţile lor, cele 27 de
elemente de balanţă, cele 19 activităţi industriale, categoriile de centrale, combustibilii şi
produsele energetice — plus purtătorii şi provenienţele.

Sunt date împreună fiindcă nu se pot presupune unele din altele: fiecare familie are altă
dimensiune, iar acelaşi nomenclator apare pe trei purtători, în unităţi diferite.

GET

https://oneapi.ro/api/energie/v1/balante/nomenclator

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Toate nomenclatoarele zonei într-un singur răspuns: cele 14 resurse primare cu unităţile lor, cele 27 de elemente de balanţă, cele 19 activităţi industriale, categoriile de centrale, combustibilii şi produsele energetice — plus purtătorii şi provenienţele.
Sunt date împreună fiindcă nu se pot presupune unele din altele: fiecare familie are altă dimensiune, iar acelaşi nomenclator apare pe trei purtători, în unităţi diferite.
Unde apare nivel, el desparte totalul publicat de sursă de componente şi de sub-poziţiile „din care" — care nu se adună între ele.

La ce folosește

Găseşti slugul potrivit înainte de a cere o serie, fără să-l ghiceşti.
Vezi în ce unităţi e publicată fiecare resursă primară.
Verifici ce e total şi ce e „din care", ca să nu aduni de două ori.

Structura răspunsului

CâmpTipDescriere

data.purtatori[] array Purtătorii de energie (cărbune, țiței, gaze, electricitate…), cu descrierea fiecăruia.

data.purtatori[].purtator string total, electrica sau termica.

data.purtatori[].descriere string Ce înseamnă şi în ce unitate e publicat.

data.proveniente[] array Proveniențele resursei: producție internă, import, stoc.

data.proveniente[].provenienta string total, productie, import, stoc_initial.

data.resurse[] array Categoriile de resursă, cu unitatea de măsură și intervalul de ani în care apar.

data.resurse[].resursa string Slugul resursei primare.

data.resurse[].um string Unitatea — o resursă apare de mai multe ori, câte o dată pentru fiecare unitate în care e publicată.

data.elemente[] array Elementele bilanțului (intrări, transformări, consum final), cu intervalul de ani.

data.elemente[].element string Slugul elementului de balanţă.

data.activitati[] array Ramurile industriale pentru care se publică consum, cu intervalul de ani.

data.activitati[].activitate string Slugul activităţii industriale.

data.centrale[] array Categoriile de centrale electrice, cu nivelul lor în ierarhie.

data.centrale[].nivel string total sau categorie.

data.combustibili[] array Combustibilii folosiți în centrale, cu nivelul în ierarhie.

data.combustibili[].nivel string total, component sau din_care — ultimul e lignitul, cuprins în cărbuni.

data.produse_energetice[] array Produsele energetice din calculul independenței, cu nivelul în ierarhie.

data.produse_energetice[].produs string Slugul produsului energetic.

data.*[].nivel Adâncimea în ierarhie. Contează: listele par plate, dar au totaluri și subtotaluri; adunând tot, numeri de două ori.

data.*[].de_la Primul an în care categoria apare la INS.

data.*[].pana_la Ultimul an în care apare. O categorie poate dispărea din nomenclator la o revizie.

meta.sursa string Setul INS din care vine nomenclatorul.

meta.nota_niveluri string Explicația ierarhiei și avertismentul contra dublei numărări.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/balante/nomenclator

{
    "data": {
        "purtatori": [
            {
                "purtator": "total",
                "descriere": "energie totală, în mii tone echivalent petrol (tep)"
            }
        ],
        "proveniente": [
            {
                "provenienta": "total",
                "descriere": "totalul resursei — producţie, import şi stoc iniţial la un loc"
            }
        ],
        "resurse": [
            {
                "resursa": "alti_combustibili",
                "resursa_denumire": "Alti combustibili",
                "um": "mii_tone_echivalent_petrol",
                "um_denumire": "Mii tone echivalent petrol",
                "de_la": 1992,
                "pana_la": 2024
            }
        ],
        "elemente": [
            {
                "element": "agricultura_si_silvicultura",
                "element_denumire": "Agricultura si silvicultura",
                "de_la": 1992,
                "pana_la": 2024
            }
        ],
        "activitati": [
            {
                "activitate": "alimentara_bauturi_si_tutun",
                "activitate_denumire": "Alimentara, bauturi si tutun",
                "de_la": 1992,
                "pana_la": 2024,
                "cerere": {
                    "grupare": "alimentara_bauturi_si_tutun"
                }
            }
        ],
        "centrale": [
            {
                "categorie": "eoliana",
                "categorie_denumire": "Eoliana",
                "nivel": "categorie",
                "de_la": 2007,
                "pana_la": 2024
            }
        ],
        "combustibili": [
            {
                "combustibil": "carbuni",
                "combustibil_denumire": "Carbuni",
                "nivel": "component",
                "de_la": 1992,
                "pana_la": 2024
            }
        ],
        "produse_energetice": [
            {
                "produs": "carbune_inclusiv_cocs",
                "produs_denumire": "Carbune (inclusiv cocs)",
                "nivel": "produs",
                "de_la": 1992,
                "pana_la": 2024
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — balanţele energetice (TEMPO, matricile IND107A-IND121A).",
        "nota_niveluri": "Unde apare `nivel`, el desparte totalul publicat de sursă de componente şi de sub-poziţiile „din care\" — care nu se adună între ele."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
429	cota_depasita	Cota 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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}