ԵՄ վառելիքի գների API Online
Վառելիքի գները EU երկրներում՝ միջին ցուցանիշներ ըստ country-ի, կոորդինատներով ամենամոտ կայանները կամ սահմանային անցակետի մոտ գտնվող կայանները։ Հավաքագրված է պաշտոնական ազգային գնային ռեգիստրներից և շուկայական տվյալներից։
GET https://nakordoni.eu/api/v1/data/fuel
— քվոտայի դաս: cheap
| Պարամետր | Նկարագրություն |
|---|---|
mode | country (default) | nearest | border. country = national average; nearest = stations near lat/lon; border = stations near a checkpoint |
country | ISO երկրի կոդ (ընտրովի) |
lat | Լայնություն (ընտրովի) |
lon | Երկայնություն (ընտրովի) |
radius_km | Search radius km for mode=nearest (default 30; alias: radius) |
ppid | Checkpoint ID for mode=border (e.g. id_13) |
fuel_type | Optional, for mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (availability varies by station/region). Local pump names are accepted as well — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — resolved against `country` (or, for coordinate products, the country the point falls in), because the same wording is not the same grade everywhere: “95” is E10 at a Danish, Finnish, French, British, Belgian or Dutch pump and E5 at a Polish or German one. The response echoes `fuel_type` (canonical), `fuel_type_requested` (as you typed it) and `fuel_type_local`. A name we cannot place is never swapped for a default grade — the answer comes back empty and says so. Full table of names per country: /api/v2/data/fuel-grades. |
lang | Լեզվի կոդ |
limit | Max stations returned for mode=nearest/border (default 5) |
Պատասխանի դաշտերը — պատասխանի ծրարի data օբյեկտի ներսում։ []-ը ցույց է տալիս ցուցակ, ուստի data.items[].name-ը յուրաքանչյուր տարրի name դաշտն է։ Դաշտը լինում է null, բացակայում է կամ դատարկ ցուցակ է, երբ արժեք չունենք․ լցոնող արժեք երբեք չենք դնում։
| Դաշտ | Նկարագրություն |
|---|---|
data.data.country | ISO-2 country the averages belong to, with country_name in the requested language. |
data.data.petrol | National average for 95-octane petrol, in data.data.currency. petrol98 is the 98-octane average, petrol92 the 92-octane one and petrol95plus the additive-enhanced 95 — each is null where the country does not report it. |
data.data.diesel | National average for diesel. |
data.data.lpg | National average for LPG, in the country's own currency; lpg_eur is the same figure converted to EUR for cross-country comparison. |
data.data.updated | Date the averages are from — daily or weekly depending on the source, never live. |
data.data.trend_petrol | up | down | null against the previous reading, and trend_diesel the same for diesel. |
data.grades | One entry per price key above: grade (our canonical code), local_name (what a driver in that country calls it) and premium. Additive — the price keys themselves are unchanged. |
data.grade_keys | Returned instead of grades when you ask for every country at once: the price key → canonical grade mapping only, without the per-country local names. |
data.labels | Localised UI strings for the keys above — for rendering, not data. |
curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Մուտք գործեք որպես ծրագրավորող՝ այս endpoint-ը ուղիղ Sandbox-ում փորձելու համար — օրական 50 անվճար թեստային կանչ։ Մուտք