API cu denumirile tipurilor de carburant Online
Tabelul de denumiri din spatele fiecărui produs legat de carburant: vocabularul nostru canonic de sortimente (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) și modul în care este numit fiecare sortiment la pompă în 41 de țări europene — ON și Olej napędowy în Polonia, Nafta în Cehia, Gázolaj în Ungaria, Motorină în România și Moldova, ДП în Ucraina, Motorin în Turcia, Gasóleo în Portugalia și Spania. Fiecare nume listat aici este acceptat de parametrul fuel_type al produselor fuel, fuel-local, fuel-stations, fuel-cheapest și fuel-cities, astfel încât puteți transmite direct formularea folosită de un șofer. Rezolvarea se face mai întâi pe țară, deoarece același cuvânt nu înseamnă același sortiment peste tot: „95” este E10 la o pompă daneză, finlandeză, franceză, britanică, belgiană sau olandeză și E5 la una poloneză sau germană — trimiteți `country` împreună cu un nume local. Acesta este un tabel de DENUMIRI și este deliberat mai larg decât acoperirea noastră de prețuri: răspunde cum se numește un sortiment într-o țară, indiferent dacă acolo cotăm sau nu un preț (pentru TR sau MD nu deținem deloc prețuri de la stații), iar `station_level` la fiecare sortiment spune doar ce sortimente sunt raportate în general de fluxurile stațiilor. Transmiteți `fuel_type` pentru a testa un nume și a primi înapoi sortimentul canonic la care se rezolvă, sau null atunci când nu îl putem identifica — nu ghicim niciodată un sortiment implicit. Fiecare sortiment poartă și priced_countries și priced_station_counts, măsurate din indexul live al stațiilor, nu scrise fix, astfel încât puteți deosebi un nume pe care îl ACCEPTĂM într-o țară (tabelul `countries`) de un sortiment pe care îl COTĂM efectiv acolo; cu ?country= fiecare sortiment poartă suplimentar priced_here, iar 0 este un răspuns real care înseamnă că respectivul cuvânt de la pompă există local, dar niciun flux nu îi atribuie un preț.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
country | Filtru ISO-2 opțional — returnează doar denumirile locale ale acelei țări în loc de toate cele 41 (PL, DE, UA, TR, MD, …). 404 dacă țara nu este în tabel. |
fuel_type | Verificare opțională: rezolvă o denumire în contextul `country` și raportează sortimentul canonic în `resolved` (de ex. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null înseamnă că nu am putut-o identifica. |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.grades[].code | Canonical grade code — the value fuel_type takes in every fuel product. |
data.grades[].label | Plain-English description of the grade. |
data.grades[].family | diesel | petrol | gas | other. |
data.grades[].station_level | true when station feeds report this grade anywhere; false means it only ever appears in national averages. |
data.countries | Keyed by ISO-2 country, then by grade code, valued with that country's names for it. The first name in each list is the one to show a driver. |
data.count | How many countries the answer covers (41 unfiltered, 1 with ?country=). |
data.resolved | Only with ?fuel_type=: requested, country, grade (null when we cannot place the name), label and local_name. |
data.note | How resolution works, in one paragraph — safe to show to your users. |
curl "https://nakordoni.eu/api/v2/data/fuel-grades?country=PL&fuel_type=ON" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizat