API für Kraftstoffsortennamen Online
Die Namenstabelle hinter jedem Kraftstoffprodukt: unser kanonisches Grad-Vokabular (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) und wie jeder Grad an einer Zapfsäule in 41 europäischen Ländern genannt wird — ON und Olej napędowy in Polen, Nafta in Tschechien, Gázolaj in Ungarn, Motorină in Rumänien und Moldau, ДП in der Ukraine, Motorin in der Türkei, Gasóleo in Portugal und Spanien. Jeder hier aufgeführte Name wird vom fuel_type-Parameter der Produkte fuel, fuel-local, fuel-stations, fuel-cheapest und fuel-cities akzeptiert, sodass Sie die Formulierung eines Fahrers direkt durchreichen können. Die Auflösung erfolgt länderweise zuerst, weil dasselbe Wort nicht überall denselben Grad bezeichnet: „95“ ist E10 an einer dänischen, finnischen, französischen, britischen, belgischen oder niederländischen Zapfsäule und E5 an einer polnischen oder deutschen — senden Sie `country` zusammen mit einem lokalen Namen. Dies ist eine NAMENSTABELLE und bewusst weiter gefasst als unsere Preisabdeckung: Sie beantwortet, wie ein Grad in einem Land genannt wird, unabhängig davon, ob wir dort einen Preis nennen (für TR oder MD führen wir überhaupt keine Stationspreise), und `station_level` bei jedem Grad sagt lediglich, welche Grade von Stationsfeeds überhaupt gemeldet werden. Übergeben Sie `fuel_type`, um einen Namen zu prüfen und den kanonischen Grad zu erhalten, zu dem er aufgelöst wird, oder null, wenn wir ihn nicht zuordnen können — wir raten niemals einen Standardgrad. Jeder Grad trägt zudem priced_countries und priced_station_counts, gemessen aus dem aktuellen Stationsindex statt fest niedergeschrieben, sodass Sie einen Namen, den wir in einem Land AKZEPTIEREN (die `countries`-Tabelle), von einem Grad unterscheiden können, den wir dort tatsächlich BEPREISEN; mit ?country= trägt jeder Grad zusätzlich priced_here, und 0 ist eine echte Antwort, die bedeutet, dass das Zapfsäulenwort lokal existiert, aber kein Feed es bepreist.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
country | Optionaler ISO-2-Filter — gibt nur die lokalen Bezeichnungen dieses Landes zurück statt aller 41 (PL, DE, UA, TR, MD, …). 404, wenn das Land nicht in der Tabelle steht. |
fuel_type | Optionale Prüfung: löst eine Bezeichnung im Kontext von `country` auf und meldet die kanonische Sorte unter `resolved` (z. B. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null bedeutet, dass wir sie nicht zuordnen konnten. |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
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"
Aktualisiert