API nazw rodzajów paliwa Online
Tabela nazewnictwa stojąca za każdym produktem paliwowym: nasze kanoniczne słownictwo gatunków (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) oraz nazwa, jaką każdy gatunek nosi na dystrybutorze w 41 krajach europejskich — ON i Olej napędowy w Polsce, Nafta w Czechach, Gázolaj na Węgrzech, Motorină w Rumunii i Mołdawii, ДП na Ukrainie, Motorin w Turcji, Gasóleo w Portugalii i Hiszpanii. Każda nazwa wymieniona tutaj jest akceptowana przez parametr fuel_type produktów fuel, fuel-local, fuel-stations, fuel-cheapest i fuel-cities, więc możesz przekazać sformułowanie użyte przez kierowcę bezpośrednio. Rozpoznawanie odbywa się w pierwszej kolejności według kraju, ponieważ to samo słowo nie oznacza tego samego gatunku wszędzie: „95” to E10 na duńskim, fińskim, francuskim, brytyjskim, belgijskim lub niderlandzkim dystrybutorze, a E5 na polskim lub niemieckim — przekaż `country` razem z nazwą lokalną. Jest to tabela NAZEWNICTWA i celowo obejmuje szerszy zakres niż nasze pokrycie cenowe: odpowiada, jak nazywa się gatunek w danym kraju, niezależnie od tego, czy podajemy tam jego cenę (dla TR czy MD nie mamy w ogóle cen ze stacji), a `station_level` przy każdym gatunku mówi jedynie, które gatunki są w ogóle zgłaszane przez kanały danych ze stacji. Przekaż `fuel_type`, aby sprawdzić jedną nazwę i otrzymać kanoniczny gatunek, do którego się rozwiązuje, albo null, gdy nie da się jej rozpoznać — nigdy nie zgadujemy domyślnego gatunku. Każdy gatunek zawiera też priced_countries i priced_station_counts, mierzone na podstawie aktywnego indeksu stacji, a nie zapisane na sztywno, dzięki czemu można odróżnić nazwę, którą AKCEPTUJEMY w danym kraju (tabela `countries`), od gatunku, który tam faktycznie WYCENIAMY; z ?country= każdy gatunek dodatkowo zawiera priced_here, a 0 jest prawdziwą odpowiedzią oznaczającą, że lokalne słowo istnieje, ale żaden kanał danych go nie wycenia.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
country | Opcjonalny filtr ISO-2 — zwraca lokalne nazwy tylko tego kraju zamiast wszystkich 41 (PL, DE, UA, TR, MD, …). 404, gdy kraju nie ma w tabeli. |
fuel_type | Opcjonalna sonda: rozpoznaje jedną nazwę w kontekście `country` i zwraca kanoniczny gatunek w polu `resolved` (np. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null oznacza, że nie udało się jej przypisać. |
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.grades[].code | Canonical grade code — the value fuel_type takes in every fuel product. |
data.grades[].label | Plain-English description of the grade. |
data.grades[].family | diesel | petrol | gas | other. |
data.grades[].station_level | true when station feeds report this grade anywhere; false means it only ever appears in national averages. |
data.countries | Keyed by ISO-2 country, then by grade code, valued with that country's names for it. The first name in each list is the one to show a driver. |
data.count | How many countries the answer covers (41 unfiltered, 1 with ?country=). |
data.resolved | Only with ?fuel_type=: requested, country, grade (null when we cannot place the name), label and local_name. |
data.note | How resolution works, in one paragraph — safe to show to your users. |
curl "https://nakordoni.eu/api/v2/data/fuel-grades?country=PL&fuel_type=ON" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Zaktualizowano