Carburanti v1 / Carburanti

Consumul anual

Consumul anual de carburanţi în mii de tone, pe ţară şi pe produs. Ultimul an publicat vine în răspuns, fiindcă sursa întârzie un an sau doi.

GET

https://oneapi.ro/api/carburanti/v1/consum

Parametri de interogare

NumeTipDescriereValori acceptate

taraopțional string | null Codul de țară. Implicit RO. ATBEBGCYCZDEDKEEESFIFRGRHRHUIEITLTLULVMTNLPLPTROSESISKUK

produsopțional string | null Opțional: restrânge la un produs. Implicit toate — ruta întoarce câte un rând pe produs, deci are sens şi fără el. benzina95motorinamotorina_incalzirepacura_sulf_micpacura_sulf_maregpl

anopțional integer | null Restrânge la un an. 1990 – 2100

Cum se comportă

Unitatea e mii de tone pentru toate produsele, inclusiv pentru cele al căror preț se publică pe 1000 de litri. Nu împărți la densitate ca să compari cu prețul — sunt două unități diferite, asumat.
Datele sunt anuale și se publică cu întârziere: ultimul_an_publicat spune până unde ajunge seria.
Fără an, primești toți anii disponibili, cel mai recent primul.

La ce folosește

Dimensionezi o piață: cât motorină se consumă anual într-o țară, ca bază pentru un plan de afaceri.
Urmărești trecerea de la motorină la alternative, comparând seriile anuale.
Raportezi ponderea unui produs în consumul total al țării.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

tara string Țara.

unitate string Întotdeauna „mii de tone".

ultimul_an_publicat integer Cel mai recent an din serie, pentru orice țară.

inregistrari integer Câte rânduri conține răspunsul.

consum[].an integer Anul.

consum[].produs string Codul produsului.

consum[].denumire string Denumirea lizibilă.

consum[].consum number Consumul, în mii de tone.

sursa object Sursa și licența.

Exemple de răspuns

GEThttps://oneapi.ro/api/carburanti/v1/consum?an=2024

{
    "data": {
        "tara": "RO",
        "unitate": "mii de tone",
        "ultimul_an_publicat": 2024,
        "inregistrari": 5,
        "consum": [
            {
                "an": 2024,
                "produs": "benzina95",
                "denumire": "Benzină Euro-super 95",
                "consum": 956.77
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Consum anual în mii de tone, indiferent de unitatea în care se publică prețul produsului."
        }
    }
}

GEThttps://oneapi.ro/api/carburanti/v1/consum?produs=motorina

{
    "data": {
        "tara": "RO",
        "unitate": "mii de tone",
        "ultimul_an_publicat": 2024,
        "inregistrari": 19,
        "consum": [
            {
                "an": 2024,
                "produs": "motorina",
                "denumire": "Motorină auto",
                "consum": 3657.58
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Consum anual în mii de tone, indiferent de unitatea în care se publică prețul produsului."
        }
    }
}

GEThttps://oneapi.ro/api/carburanti/v1/consum

{
    "data": {
        "tara": "RO",
        "unitate": "mii de tone",
        "ultimul_an_publicat": 2024,
        "inregistrari": 97,
        "consum": [
            {
                "an": 2024,
                "produs": "benzina95",
                "denumire": "Benzină Euro-super 95",
                "consum": 956.77
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Consum anual în mii de tone, indiferent de unitatea în care se publică prețul produsului."
        }
    }
}

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	Cod de țară sau de produs necunoscut.
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": "Cod de țară sau de produs necunoscut.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}