Odosielanie správ a flotila NakBus sú teraz na partnerskom paneli
Prepojte svoj vývojársky účet s účtom Nakordoni Partners s rovnakým e-mailom a spravujte tam správy a svoju autobusovú flotilu (NakDriver / NakManager) s tímovými rolami. Vaše API kľúče, koncové body a aplikácie zostávajú nezmenené a stránky tu naďalej fungujú. Otvoriť Nakordoni Partners

← Všetky endpointy

API cien paliva v EÚ Online

Ceny paliva v krajinách EU — priemery podľa country, najbližšie stanice podľa súradníc alebo stanice v blízkosti hraničného priechodu. Agregované z oficiálnych národných cenových registrov a trhových údajov.

GET https://nakordoni.eu/api/v1/data/fuel — trieda kvóty: cheap

ParameterPopis
modecountry (predvolene) | nearest | border. country = celoštátny priemer; nearest = čerpacie stanice pri lat/lon; border = stanice pri hraničnom priechode
countryKód krajiny ISO (voliteľné)
latZemepisná šírka (voliteľné)
lonZemepisná dĺžka (voliteľné)
radius_kmPolomer vyhľadávania v km pre mode=nearest (predvolene 30; alias: radius)
ppidID hraničného priechodu pre mode=border (napr. id_13)
fuel_typeVoliteľné, pre mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (dostupnosť sa líši podľa stanice/regiónu). Akceptujú sa aj miestne názvy z výdajných stojanov — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — vyhodnocujú sa voči `country` (alebo, pri súradnicových produktoch, voči krajine, do ktorej bod spadá), pretože to isté pomenovanie neznamená všade rovnaký druh: „95“ je na dánskom, fínskom, francúzskom, britskom, belgickom či holandskom stojane E10 a na poľskom alebo nemeckom E5. Odpoveď vracia `fuel_type` (kanonický), `fuel_type_requested` (v podobe, ako ste ho zadali) a `fuel_type_local`. Názov, ktorý nedokážeme zaradiť, sa nikdy nenahradí predvoleným druhom — odpoveď príde prázdna a povie to. Úplná tabuľka názvov podľa krajín: /api/v2/data/fuel-grades.
langKód jazyka
limitMaximum staníc pre mode=nearest/border (predvolene 5)

Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.

PolePopis
data.data.countryISO-2 country the averages belong to, with country_name in the requested language.
data.data.petrolNational average for 95-octane petrol, in data.data.currency. petrol98 is the 98-octane average, petrol92 the 92-octane one and petrol95plus the additive-enhanced 95 — each is null where the country does not report it.
data.data.dieselNational average for diesel.
data.data.lpgNational average for LPG, in the country's own currency; lpg_eur is the same figure converted to EUR for cross-country comparison.
data.data.updatedDate the averages are from — daily or weekly depending on the source, never live.
data.data.trend_petrolup | down | null against the previous reading, and trend_diesel the same for diesel.
data.gradesOne entry per price key above: grade (our canonical code), local_name (what a driver in that country calls it) and premium. Additive — the price keys themselves are unchanged.
data.grade_keysReturned instead of grades when you ask for every country at once: the price key → canonical grade mapping only, without the per-country local names.
data.labelsLocalised UI strings for the keys above — for rendering, not data.
curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Prihláste sa ako vývojár a vyskúšajte tento endpoint naživo v sandboxe — 50 bezplatných testovacích volaní denne. Prihlásiť sa

Aktualizované