Dërgimi i lajmeve dhe flota NakBus tani janë në panelin e partnerit
Lidhni llogarinë tuaj të zhvilluesit me një llogari Nakordoni Partners me të njëjtin email dhe menaxhoni atje lajmet dhe flotën tuaj të autobusëve (NakDriver / NakManager), me role ekipi. Çelësat tuaj API, endpoints dhe aplikacionet mbeten të pandryshuara, dhe faqet këtu vazhdojnë të funksionojnë. Hap Nakordoni Partners

← Të gjithë endpoint-et

API e Çmimeve të Karburantit në BE Online

Çmimet e karburantit në vendet e EU — mesataret sipas country, stacionet më të afërta sipas koordinatave, ose stacionet pranë një pike kalimi kufitar. Të agreguara nga regjistrat zyrtarë kombëtarë të çmimeve dhe të dhënat e tregut.

GET https://nakordoni.eu/api/v1/data/fuel — klasa e kuotës: cheap

ParametriPërshkrimi
modecountry (parazgjedhje) | nearest | border. country = mesatarja kombëtare; nearest = pika karburanti pranë lat/lon; border = pika karburanti pranë një pike kufitare
countryKodi ISO i vendit (opsionale)
latGjerësia gjeografike (opsionale)
lonGjatësia gjeografike (opsionale)
radius_kmRrezja e kërkimit në km për mode=nearest (parazgjedhje 30; alias: radius)
ppidID-ja e pikës kufitare për mode=border (p.sh. id_13)
fuel_typeOpsional, për mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (disponueshmëria ndryshon sipas stacionit/rajonit). Pranohen edhe emërtimet vendore te pompa — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — ato zgjidhen në raport me `country` (ose, për produktet me koordinata, me vendin ku bie pika), sepse i njëjti emërtim nuk do të thotë kudo i njëjti lloj: „95“ është E10 te një pompë daneze, finlandeze, franceze, britanike, belge ose holandeze dhe E5 te një pompë polake ose gjermane. Përgjigja kthen `fuel_type` (kanonik), `fuel_type_requested` (siç e shkruat) dhe `fuel_type_local`. Një emërtim që nuk mund ta identifikojmë nuk zëvendësohet kurrë me një lloj të parazgjedhur — përgjigja kthehet bosh dhe e thotë këtë. Tabela e plotë e emërtimeve sipas vendeve: /api/v2/data/fuel-grades.
langKodi i gjuhës
limitMaksimumi i pikave të karburantit për mode=nearest/border (parazgjedhje 5)

Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.

FushaPërshkrimi
data.data.countryISO-2 country the averages belong to, with country_name in the requested language.
data.data.petrolNational 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.dieselNational average for diesel.
data.data.lpgNational average for LPG, in the country's own currency; lpg_eur is the same figure converted to EUR for cross-country comparison.
data.data.updatedDate the averages are from — daily or weekly depending on the source, never live.
data.data.trend_petrolup | down | null against the previous reading, and trend_diesel the same for diesel.
data.gradesOne 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_keysReturned 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.labelsLocalised 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"
🔑 Hyni si zhvillues për ta provuar këtë endpoint drejtpërdrejt në Sandbox — 50 thirrje testimi falas në ditë. Hyni

Përditësuar