API des noms de carburants Online
La table de nommage derrière chaque produit carburant : notre vocabulaire canonique de qualités (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) et le nom donné à chaque qualité à la pompe dans 41 pays européens — ON et Olej napędowy en Pologne, Nafta en Tchéquie, Gázolaj en Hongrie, Motorină en Roumanie et en Moldavie, ДП en Ukraine, Motorin en Turquie, Gasóleo au Portugal et en Espagne. Chaque nom listé ici est accepté par le paramètre fuel_type des produits fuel, fuel-local, fuel-stations, fuel-cheapest et fuel-cities, ce qui vous permet de transmettre directement le mot employé par un automobiliste. La résolution se fait d'abord par pays car le même mot ne désigne pas la même qualité partout : “95” est de l'E10 à une pompe danoise, finlandaise, française, britannique, belge ou néerlandaise, et de l'E5 à une pompe polonaise ou allemande — envoyez `country` avec un nom local. Il s'agit d'une table de NOMMAGE, délibérément plus large que notre couverture des prix : elle répond à la question de savoir comment une qualité est appelée dans un pays, que nous y cotions un prix ou non (nous n'avons aucun prix de station pour TR ou MD), et `station_level` sur chaque qualité indique seulement quelles qualités les flux de stations rapportent, où que ce soit. Passez `fuel_type` pour tester un nom et récupérer la qualité canonique à laquelle il se résout, ou null quand nous ne pouvons pas l'identifier — nous ne devinons jamais une qualité par défaut. Chaque qualité porte aussi priced_countries et priced_station_counts, mesurés depuis l'index de stations en direct plutôt qu'écrits à l'avance, afin que vous puissiez distinguer un nom que nous ACCEPTONS pour un pays (la table `countries`) d'une qualité que nous COTONS réellement là-bas ; avec ?country= chaque qualité porte en plus priced_here, et 0 est une réponse réelle signifiant que le mot de la pompe existe localement mais qu'aucun flux ne le cote.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— classe de quota: cheap
| Paramètre | Description |
|---|---|
country | Filtre ISO-2 facultatif — ne renvoie que les noms locaux de ce pays au lieu des 41 (PL, DE, UA, TR, MD, …). 404 si le pays n'est pas dans la table. |
fuel_type | Sonde facultative : résout un nom dans le contexte de `country` et indique le carburant canonique dans `resolved` (p. ex. country=PL&fuel_type=ON → diesel ; country=DK&fuel_type=95 → e10 ; country=PL&fuel_type=95 → e5). null signifie que nous n'avons pas pu le situer. |
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é.
| Champ | Description |
|---|---|
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"
Mis à jour