Carburanti v1 / Carburanti

Nomenclatorul modulului

Produsele cu unitățile lor și țările din serie, fiecare cu perioada acoperită.

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Fetch-uiește-l o dată și mapează local. E răspunsul care îți spune ce valori sunt valide pentru produs și tara peste tot în modul.
in_litri spune dacă produsul are preț pe litru. Păcura se publică pe tonă și nu se poate converti — densitatea nu e o constantă pe care s-o presupunem.
Acoperirea pe țări nu e uniformă: România începe în 2008, majoritatea în 2005, iar Marea Britanie se oprește în 2020.
moneda_curenta e moneda ultimei săptămâni a țării. Rândurile mai vechi ale unei țări care a adoptat euro rămân în moneda de atunci.

La ce folosește

Populezi un dropdown de produs sau de țară cu exact valorile pe care le acceptă restul rutelor.
Afli de când există date pentru o țară înainte să ceri o serie care ar veni goală.
Verifici ce unitate are un produs, ca să nu ceri „pe litru" acolo unde prețul e pe tonă.

Structura răspunsului

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

CâmpTipDescriere

produse[].cod string Valoarea de folosit în parametrul produs.

produse[].denumire string Denumirea lizibilă.

produse[].unitate string 1000l sau t.

produse[].in_litri boolean Dacă produsul are preț pe litru.

tari[].cod string Valoarea de folosit în parametrul tara.

tari[].moneda_curenta string Moneda ultimei săptămâni raportate de țară.

tari[].prima_saptamana string Prima săptămână cu date.

tari[].ultima_saptamana string Ultima săptămână cu date.

tari[].inregistrari integer Câte rânduri de preț are țara în total.

pseudo_coduri[] array Coduri care arată a produs dar nu sunt: rânduri de total sau de metadate din buletin. Sunt listate ca să nu fie confundate cu produse reale.

pseudo_coduri[].cod string EU sau EA.

pseudo_coduri[].denumire string Ce reprezintă pseudo-codul.

sursa object Sursa și licența.

Exemple de răspuns

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

{
    "data": {
        "produse": [
            {
                "cod": "benzina95",
                "denumire": "Benzină Euro-super 95",
                "unitate": "1000l",
                "in_litri": true
            }
        ],
        "tari": [
            {
                "cod": "AT",
                "moneda_curenta": "EUR",
                "prima_saptamana": "2005-01-03",
                "ultima_saptamana": "2026-09-14",
                "inregistrari": 4239
            }
        ],
        "pseudo_coduri": [
            {
                "cod": "EU",
                "denumire": "Media Uniunii Europene"
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Prețuri medii naționale raportate de statele membre pentru săptămâna indicată, nu prețuri per stație de alimentare."
        }
    }
}

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."
    }
}