API de nombres de carburantes Online
La tabla de nomenclatura detrás de cada producto de combustible: nuestro vocabulario canónico de grados (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) y cómo se llama cada grado en el surtidor en 41 países europeos — ON y Olej napędowy en Polonia, Nafta en Chequia, Gázolaj en Hungría, Motorină en Rumanía y Moldavia, ДП en Ucrania, Motorin en Turquía, Gasóleo en Portugal y España. Todos los nombres aquí listados son aceptados por el parámetro fuel_type de los productos fuel, fuel-local, fuel-stations, fuel-cheapest y fuel-cities, así que puede pasar directamente la palabra que usaría un conductor. La resolución es primero por país, porque la misma palabra no es el mismo grado 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 — envíe `country` junto con un nombre local. Esta es una tabla de NOMENCLATURA y es deliberadamente más amplia que nuestra cobertura de precios: responde cómo se llama un grado en un país, tengamos o no un precio cotizado allí (no tenemos ningún precio de estación para TR ni MD), y station_level en cada grado indica solo qué grados reportan en algún lugar los feeds de estaciones. Pase fuel_type para consultar un nombre y obtener el grado canónico al que corresponde, o null cuando no podemos identificarlo — nunca adivinamos un grado por defecto. Cada grado también lleva priced_countries y priced_station_counts, medidos a partir del índice de estaciones en vivo y no escritos de antemano, para que pueda distinguir un nombre que ACEPTAMOS en un país (la tabla `countries`) de un grado que realmente COTIZAMOS allí; con ?country= cada grado lleva además priced_here, y 0 es una respuesta real que significa que la palabra del surtidor existe localmente pero ningún feed lo cotiza.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
country | Filtro ISO-2 opcional: devuelve solo los nombres locales de ese país en lugar de los 41 (PL, DE, UA, TR, MD, …). 404 si el país no está en la tabla. |
fuel_type | Comprobación opcional: resuelve un nombre en el contexto de `country` e indica el carburante canónico en `resolved` (p. ej. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null significa que no hemos podido situarlo. |
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.
| Campo | Descripción |
|---|---|
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"
Actualizado