Trimiterea știrilor și flota NakBus se află acum în panoul de partener
Conectați-vă contul de dezvoltator la un cont Nakordoni Partners cu același e-mail și gestionați acolo știrile și flota dvs. de autobuze (NakDriver / NakManager), cu roluri de echipă. Cheile API, punctele finale și aplicațiile dvs. rămân neschimbate, iar paginile de aici continuă să funcționeze. Deschide Nakordoni Partners

← Toate endpointurile

API Prețuri combustibil pe orașe Online

Prețuri carburant pe orașe: cea mai ieftină stație și media din top 5 stații per oraș major.

GET https://nakordoni.eu/api/v1/data/fuel-cities — clasă de cotă: cheap

ParametruDescriere
countryCod de țară ISO-2 (obligatoriu). Acceptate: at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro răspunde momentan fără orașe (nu sunt înregistrate stații cu prețuri)
fuel_typediesel (implicit) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — disponibilitatea este per țară, nu per platformă. Citiți `available_fuel_types` din răspuns și alegeți din acesta; un sortiment absent din acea listă returnează un array `cities` gol cu un `note`, nu un sortiment de rezervă. Sunt acceptate și denumirile locale de la pompă — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rezolvate în raport cu `country` (sau, pentru produsele pe coordonate, cu țara în care cade punctul), deoarece aceeași formulare nu înseamnă peste tot același sortiment: „95” este E10 la o pompă daneză, finlandeză, franceză, britanică, belgiană sau olandeză și E5 la una poloneză sau germană. Răspunsul returnează `fuel_type` (canonic), `fuel_type_requested` (așa cum l-ați scris) și `fuel_type_local`. O denumire pe care nu o putem identifica nu este niciodată înlocuită cu un sortiment implicit — răspunsul vine gol și o spune explicit. Tabelul complet al denumirilor pe țări: /api/v2/data/fuel-grades.
langCodul limbii pentru numele orașelor (implicit en)

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âmpDescriere
data.countryISO-2 country, with country_name in the requested language.
data.fuel_typeThe canonical grade the prices are for. fuel_type_requested is what you sent, fuel_type_local the name a driver there uses.
data.available_fuel_typesGrades this country actually has priced stations for — derived from the data, not a menu. Pick fuel_type from it.
data.available_fuel_types_localThe same list keyed by grade, valued with the local pump name.
data.cities[].city_nameCity, with city_key, lat and lng.
data.cities[].cheapestLowest station price in that city, with avg_price across the top stations, both in data.currency.
data.cities[].stations[]The stations behind those numbers: name, brand, price, lat, lng.
data.countCities returned. An empty cities list with a note means the country has no price for that grade — it is never answered with a different grade.
curl "https://nakordoni.eu/api/v1/data/fuel-cities?country=hr&fuel_type=diesel&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Autentifică-te ca dezvoltator pentru a testa acest endpoint live în sandbox — 50 de apeluri de test gratuite pe zi. Autentificare

Actualizat