API назива горива Online
Табела назива иза сваког производа за гориво: наш канонски речник марки (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) и како се свака марка зове на пумпи у 41 европској земљи — ON и Olej napędowy у Пољској, Nafta у Чешкој, Gázolaj у Мађарској, Motorină у Румунији и Молдавији, ДП у Украјини, Motorin у Турској, Gasóleo у Португалу и Шпанији. Сваки назив наведен овде прихвата параметар fuel_type производа fuel, fuel-local, fuel-stations, fuel-cheapest и fuel-cities, тако да можете директно да проследите израз који користи возач. Разрешавање иде прво по земљи јер иста реч није иста марка свуда: “95” је E10 на данској, финској, француској, британској, белгијској или холандској пумпи, а E5 на пољској или немачкој — пошаљите `country` заједно са локалним називом. Ово је табела за ИМЕНОВАЊЕ и намерно је шира од наше ценовне покривености: одговара на питање како се марка зове у некој земљи без обзира да ли тамо наводимо цену (за TR и MD уопште немамо цене станица), а `station_level` код сваке марке показује само које марке пријављују извори података о станицама било где. Проследите `fuel_type` да проверите један назив и добијете канонску марку на коју се разрешава, или null када не можемо да га препознамо — никада не претпостављамо подразумевану марку. Свака марка такође носи priced_countries и priced_station_counts, измерене из живог индекса станица а не унапред записане, тако да можете да разликујете назив који ПРИХВАТАМО за неку земљу (табела `countries`) од марке за коју стварно НАВОДИМО цену тамо; са ?country= свака марка додатно носи priced_here, а 0 је стваран одговор што значи да реч за пумпу локално постоји, али ниједан извор је не цењује.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— класа квоте: cheap
| Параметар | Опис |
|---|---|
country | Опциони ISO-2 филтер — враћа само локалне називе те земље уместо свих 41 (PL, DE, UA, TR, MD, …). 404 ако земље нема у табели. |
fuel_type | Опциона провера: разрешава један назив у контексту `country` и канонску врсту враћа у пољу `resolved` (нпр. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null значи да нисмо успели да га сврстамо. |
Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.
| Поље | Опис |
|---|---|
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"
Ažurirano