El envío de noticias y la flota NakBus ahora están en el panel de socio
Conecta tu cuenta de desarrollador a una cuenta de Nakordoni Partners con el mismo correo electrónico y gestiona allí las noticias y tu flota de autobuses (NakDriver / NakManager), con roles de equipo. Tus claves API, endpoints y aplicaciones permanecen sin cambios, y las páginas aquí siguen funcionando. Abrir Nakordoni Partners

← Todos los endpoints

API de precios de combustible por ciudad Online

Resumen de precios de combustible por ciudad: la estación más barata y media de las 5 más económicas.

GET https://nakordoni.eu/api/v1/data/fuel-cities — clase de cuota: cheap

ParámetroDescripción
countryCódigo de país ISO-2 (obligatorio). Aceptados: at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro responde actualmente sin ciudades (no hay estaciones con precios registradas)
fuel_typediesel (predeterminado) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — la disponibilidad es por país, no por plataforma. Lea `available_fuel_types` en la respuesta y elija de ahí; un carburante ausente de esa lista devuelve un array `cities` vacío con un `note`, no un carburante alternativo. También se aceptan las denominaciones locales de surtidor — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — se resuelven contra `country` (o, en los productos por coordenadas, contra el país en el que cae el punto), porque la misma denominación no significa el mismo carburante en todas partes: «95» es E10 en un surtidor danés, finlandés, francés, británico, belga u holandés y E5 en uno polaco o alemán. La respuesta devuelve `fuel_type` (canónico), `fuel_type_requested` (tal como lo escribió) y `fuel_type_local`. Una denominación que no podemos ubicar nunca se sustituye por un carburante predeterminado: la respuesta vuelve vacía y así lo indica. Tabla completa de denominaciones por país: /api/v2/data/fuel-grades.
langCódigo de idioma para los nombres de ciudades (por defecto en)

Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.

CampoDescripción
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"
🔑 Inicia sesión como desarrollador para probar este endpoint en vivo en el sandbox — 50 llamadas de prueba gratuitas al día. Iniciar sesión

Actualizado