La soumission d'actualités et la flotte NakBus sont désormais dans le tableau de bord partenaire
Connectez votre compte développeur à un compte Nakordoni Partners avec la même adresse e-mail et gérez-y les actualités et votre flotte de bus (NakDriver / NakManager), avec des rôles d'équipe. Vos clés API, points de terminaison et applications restent inchangés, et les pages ici continuent de fonctionner. Ouvrir Nakordoni Partners

← Tous les endpoints

API Prix carburant par ville Online

Prix carburant par ville: station la moins chère et moyenne des 5 moins chères par grande ville.

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

ParamètreDescription
countryCode pays ISO-2 (obligatoire). Acceptés : at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro répond actuellement sans aucune ville (aucune station avec prix enregistrée)
fuel_typediesel (par défaut) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — la disponibilité dépend du pays, pas de la plateforme. Lisez `available_fuel_types` dans la réponse et choisissez-y ; un carburant absent de cette liste renvoie un tableau `cities` vide accompagné d'un `note`, et non un carburant de repli. Les appellations locales à la pompe sont également acceptées — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — elles sont résolues par rapport à `country` (ou, pour les produits par coordonnées, au pays dans lequel tombe le point), car le même libellé ne désigne pas partout le même carburant : « 95 » correspond à E10 sur une pompe danoise, finlandaise, française, britannique, belge ou néerlandaise, et à E5 sur une pompe polonaise ou allemande. La réponse renvoie `fuel_type` (canonique), `fuel_type_requested` (tel que vous l'avez saisi) et `fuel_type_local`. Une appellation que nous ne savons pas situer n'est jamais remplacée par un carburant par défaut : la réponse revient vide et le signale. Tableau complet des appellations par pays : /api/v2/data/fuel-grades.
langCode de langue pour les noms de villes (par défaut en)

Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.

ChampDescription
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"
🔑 Connectez-vous en tant que développeur pour essayer cet endpoint en direct dans la sandbox — 50 appels de test gratuits par jour. Connexion

Mis à jour