Zgłaszanie newsów i flota NakBus są teraz w panelu partnera
Połącz swoje konto dewelopera z kontem Nakordoni Partners przy użyciu tego samego adresu e-mail i zarządzaj tam newsami oraz swoją flotą autobusów (NakDriver / NakManager), z rolami zespołu. Twoje klucze API, endpointy i aplikacje pozostają bez zmian, a strony tutaj nadal działają. Otwórz Nakordoni Partners
API cen paliwa według miast Online
Podsumowanie cen paliwa dla każdego dużego miasta w kraju: najtańsza stacja i średnia z 5 najtańszych.
GET https://nakordoni.eu/api/v1/data/fuel-cities
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
country | Kod kraju ISO-2 (wymagany). Akceptowane: at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro obecnie odpowiada bez miast (brak zarejestrowanych stacji z cenami) |
fuel_type | diesel (domyślnie) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — dostępność zależy od kraju, nie od platformy. Odczytaj `available_fuel_types` w odpowiedzi i wybieraj z tej listy; gatunek na niej nieobecny zwraca pustą tablicę `cities` z polem `note`, a nie gatunek zastępczy. Akceptowane są także lokalne nazwy paliw z dystrybutorów — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rozpoznawane względem `country` (lub, w produktach współrzędnych, względem kraju, w którym leży punkt), ponieważ to samo określenie nie wszędzie oznacza ten sam gatunek: „95” to E10 na duńskim, fińskim, francuskim, brytyjskim, belgijskim lub niderlandzkim dystrybutorze, a E5 na polskim lub niemieckim. Odpowiedź zwraca `fuel_type` (kanoniczny), `fuel_type_requested` (w postaci wpisanej przez Ciebie) oraz `fuel_type_local`. Nazwa, której nie potrafimy przypisać, nigdy nie jest podmieniana na domyślny gatunek — odpowiedź wraca pusta i informuje o tym. Pełna tabela nazw według krajów: /api/v2/data/fuel-grades. |
lang | Kod języka nazw miast (domyślnie en) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.country | ISO-2 country, with country_name in the requested language. |
data.fuel_type | The 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_types | Grades this country actually has priced stations for — derived from the data, not a menu. Pick fuel_type from it. |
data.available_fuel_types_local | The same list keyed by grade, valued with the local pump name. |
data.cities[].city_name | City, with city_key, lat and lng. |
data.cities[].cheapest | Lowest 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.count | Cities 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"
🔑 Zaloguj się jako deweloper, aby wypróbować ten endpoint na żywo w piaskownicy — 50 darmowych wywołań testowych dziennie. Zaloguj się
Zaktualizowano