API pentru cel mai ieftin combustibil din apropiere Online
Cele mai ieftine benzinării din jurul unui punct sau al unui oraș, clasate după preț pentru tipul de carburant ales (la egalitate câștigă cea mai apropiată). Acoperirea la nivel de stație cuprinde 39 de țări europene și este MĂSURATĂ, nu fixă: orice răspuns gol returnează lista actuală de țări cu numărul de stații pentru fiecare țară în obiectul coverage, limitată la sortimentul solicitat — citiți această valoare, nu o listă din această descriere. Clasamentul se face pentru un singur tip de carburant în cadrul unei arii de căutare, iar prețurile poartă moneda proprie a fiecărei stații (PLN în Polonia, EUR în rest). Când nicio stație nu corespunde, răspunsul include un obiect coverage în loc de o listă goală tăcută: station_countries și station_counts măsurate din indexul live (limitate la `grade` atunci când ați indicat un fuel_type), sparse_coverage pentru țările cu 25 sau mai puține stații cu preț, measured_at și un fuel_type_note care separă cele două motive pentru care un răspuns poate fi gol — un nume de sortiment pe care nu l-am putut identifica, față de un sortiment pe care îl recunoaștem, dar nu îl prețuim în acea țară.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
lat | Latitudine |
lon | Longitudine |
city | Numele orașului — alternativă la lat/lon, convertit în coordonate |
country | Cod de țară ISO-2, dezambiguizează orașul |
radius_km | Raza de căutare în km (implicit 25, maxim 25; alias: radius) |
fuel_type | diesel (implicit) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — clasamentul după preț se face pentru fiecare tip de carburant. Sunt acceptate și denumirile locale de la pompă — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rezolvate în raport cu `country` (sau, pentru produsele pe coordonate, țara în care cade punctul), pentru că aceeași formulare nu înseamnă același sortiment peste tot: „95” este E10 la o pompă daneză, finlandeză, franceză, britanică, belgiană sau olandeză și E5 la una poloneză sau germană. Răspunsul returnează `fuel_type` (canonic), `fuel_type_requested` (așa cum l-ați scris) și `fuel_type_local`. O denumire pe care nu o putem identifica nu este niciodată înlocuită cu un sortiment implicit — răspunsul vine gol și o spune. Tabelul complet al denumirilor pe țări: /api/v2/data/fuel-grades. |
limit | Număr maxim de stații (implicit 5, maxim 20) |
lang | Limba etichetelor (implicit en) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.stations[] | The same station objects as fuel-stations (grades nested under prices, one entry per physical station), ranked cheapest first for the chosen grade — closest wins a tie, and a station without a quote for that grade ranks last. |
data.anchor | The point searched and the resolved grade: lat, lng, radius_km, fuel_type, fuel_type_requested, fuel_type_local, fuel_type_country. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.coverage | Only when nothing matched — grade, station_countries + station_counts measured from the live index (scoped to that grade), sparse_coverage, measured_at, and fuel_type_note for both an unplaceable grade name and a recognised grade we do not price in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-cheapest?city=Munich&country=DE&radius_km=25" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizat