Zoznam zmien API

Nový produkt lane-cost-index (GET /api/v2/data/lane-cost-index). Vracia nákladový index jednej naloženej jazdy kamióna z A do B v Európe: palivo, mýto, čas vodiča a diéty.

• Vstup: from a to ako "lat,lng" alebo id mesta, vehicle (napríklad artic_40t), voliteľne euro, co2_class a empty_return.
• Podľa krajiny: km, mýto, litre nafty a náklady na palivo (bez DPH) a trieda vozidla použitá pre mýto.
• Čas vodiča: jazda, prestávky a odpočinky podľa pravidiel EÚ 561/2006. Náklady na vodiča a diéty používajú sadzbu krajiny pôvodu. Španielsko a Taliansko majú teraz sadzbu vodiča a diéty z kolektívnych zmlúv.
• Trend: trend uvádza nákladový index aktuálneho a dvoch predchádzajúcich mesiacov.
• Neúplné údaje: keď krajina na trase nemá údaje o mýte alebo palive, alebo krajina pôvodu nemá sadzbu vodiča, incomplete je true a súčet je dolná hranica. missing_countries a missing_components ukazujú, čo chýba.

Ide o nákladový index, nie o cenu prepravy: kapitál vozidla, poistenie, režijné náklady a marža nie sú zahrnuté.

Kvóta: jedna požiadavka sa počíta ako 1 jednotka triedy route, rovnako ako truck-route.

Dokumentácia: Lane Cost Index.

Produkt toll-cost presnejšie oceňuje Francúzsko, Španielsko a Taliansko.

• Francúzsko a Španielsko: úsek diaľnice medzi dvoma mýtnymi stanicami na trase sa oceňuje podľa tarify vjazd/výjazd prevádzkovateľa diaľnice. Zobrazuje sa ako nový typ položky motorway_section s prevádzkovateľom alebo cestou, dvoma stanicami, toll_km a cost_eur. Ostatné spoplatnené km krajiny naďalej používajú priemernú sadzbu za km.
• Trieda vozidla: Francúzsko: trieda 3 pre 2 nápravy a trieda 4 pre 3 a viac náprav. Španielsko: Pesados 1 pre 2 alebo 3 nápravy a Pesados 2 pre 4 a viac náprav.
• Taliansko: nákladné vozidlá s 2 a 3 nápravami majú teraz vlastné sadzby za km.
• Trieda Euro a CO2: francúzske, talianske a španielske tarify nezávisia od týchto tried. Keď pošlete euro alebo co2_class, class_fallback je pre tieto krajiny false a class_note uvádza dôvod.
• Bez spoplatnenej cesty: trasa cez Španielsko bez spoplatnenej cesty (napríklad Zaragoza – Barcelona) vráti Španielsko s cost_eur 0 a scheme not_tolled.

Ostatné krajiny sa nemenia. Dokumentácia: Truck Toll Cost.

Nový produkt toll-cost (POST /api/v2/data/toll-cost, telo JSON). Vracia výšku mýta pre nákladné vozidlo na trase po Európe.

• Vstup: línia trasy ako coordinates (napríklad geometria z truck-route) alebo waypoints, pre ktoré vypočítame trasu naším smerovaním pre nákladné vozidlá.
• Vozidlo: axles, gross_weight_t, euro a co2_class. Voliteľne date pre tarify a currency pre celkovú sumu.
• Podľa krajín: spoplatnené km, efektívna sadzba EUR za km, náklady, ocenená trieda vozidla a dátum tarify. Sadzby pre konkrétnu triedu Euro a CO2 sa použijú tam, kde je pre túto triedu k dispozícii oficiálna tarifa. Inak sa použije sadzba predvolenej triedy a class_fallback je true.
• Samostatné položky: koncesné úseky diaľnic a tunely a mosty s vlastným mýtom pre nákladné vozidlá (napríklad Calafat-Vidin).

Kvóta: jedna požiadavka sa počíta ako 1 jednotka triedy route, rovnako ako truck-route.

Dokumentácia: Truck Toll Cost.

Dva nové produkty v /api/v2. Pre cestu autobusom ukazujú, ktorá strana je na slnku a ktorá v tieni, a ktoré miesta sú najlepšie pre tieň alebo výhľad.

• bus-sun-side (/api/v2/data/bus-sun-side), GET: trasa z nášho registra autobusových trás (route_id, dir, date) alebo voľná cesta (from, to, depart).
• bus-sun-side, POST: pošlite vlastnú trasu ako zoznam zastávok, líniu GeoJSON alebo kódovanú polylíniu. Pridajte parametre autobusu (rady, rozloženie sedadiel, strana dverí, okná, podlažie) alebo vyberte model z katalógu cez bus_model.
• Počasie: pre cesty v najbližších 3 dňoch sa používa hodinová predpoveď pozdĺž trasy. Neskoršie cesty sa počítajú pre jasnú oblohu. Pošlite weather=0, ak chcete vždy výsledok pre jasnú oblohu.
• Obrázky (POST): plán sedadiel, mapa trasy a časová os ako URL vo formáte PNG, WebP alebo JPG. Obrázky sa uchovávajú 12 hodín. Dostanete aj embed_html na vloženie výsledku na vašu stránku. URL obrázkov začínajú na https://api.nakordoni.dev/images/.
• Animácia: blok animation obsahuje snímku každých 5 minút s polohou autobusu, smerom jazdy, azimutom a výškou slnka a slnečnou stranou, s popismi vo vašom jazyku, súčtami pre strany a legendou. Pošlite animation=0, ak ho nechcete.
• Widget: zobrazte výsledok na akomkoľvek webe, aj vo WordPresse, cez tag script alebo iframe. Widget používa verejný kľúč, ktorý funguje len na vami povolených doménach (origins), a naše vlastné mapové dlaždice. K dispozícii je plugin pre WordPress (zip).
• bus-sun-catalog (/api/v2/data/bus-sun-catalog): modely autobusov, ktoré prijíma bus-sun-side, s rozložením sedadiel a oknami.

Kvóta: požiadavka POST s obrázkami sa počíta ako 2 jednotky. Všetky ostatné požiadavky ako 1 jednotka.

Dokumentácia: Bus Sun Side.

fleet-compliance-validate teraz pokrýva väčšiu časť nariadenia EU 561/2006 v znení nariadenia (EÚ) 2020/1054. Existujúce polia odpovede sa nemenia; pridávajú sa nové polia.

• Výnimka podľa čl. 12: jazdné aktivity označte pomocou art12_exceed: true. Vo výnimočných prípadoch môže vodič prekročiť denné a týždenné limity jazdy až o 1 h, aby dosiahol prevádzkové stredisko alebo domov na týždenný odpočinok, alebo až o 2 h po prestávke 30 min, ak nasleduje pravidelný týždenný odpočinok. Validátor to akceptuje a vráti dlžnú kompenzáciu a jej lehotu (koniec tretieho nasledujúceho týždňa) v remaining.driving.art12_compensation a exceptions.art12.
• Návrat do základne podľa čl. 8 ods. 8a: pri týždenných odpočinkoch posielajte location (residence, operational_centre alebo elsewhere). Dostanete upozornenie, ak 4 po sebe idúce týždne neobsahujú pravidelný týždenný odpočinok doma alebo v prevádzkovom stredisku.
• 12-dňová odchýlka podľa čl. 8 ods. 6a: passenger_12day: true pre jednu príležitostnú medzinárodnú autobusovú dopravnú službu. Týždenný odpočinok potom môže nasledovať až po dvanástich 24-hodinových obdobiach od pravidelného týždenného odpočinku. Kontrolujú sa následné odpočinky a nočná jazda (22:00-06:00). Čl. 8 ods. 6 písm. b) AETR sa uplatňuje rovnako.
• Vnútroštátne nočné okná (smernica 2002/15/ES čl. 3 písm. h): pomocou country alebo wtd.country uplatníte vnútroštátne nočné obdobie. Overené: AT, IE (cestujúci samostatne) a SE. Ostatné krajiny EÚ/EHP používajú 00:00-04:00 a vracajú night_window_verified: false.
• fleet-compliance-limits: AETR teraz uvádza skontrolované zmeny po roku 2010. Menia iba článok 14, nie pravidlá jazdy ani odpočinku.

Dokumentácia: Fleet Compliance.

Štyri nové produkty, poskytované z /api/v2 a vypočítané naším vlastným pravidlovým jadrom sviatkov pre 51 krajín (Európa a Perzský záliv: SA, AE, QA, KW, BH, OM), 2020-2035:

• holiday-calendar-holidays (/api/v2/data/holiday-calendar/holidays) — štátne, bankové, regionálne, náboženské a pamätné sviatky pre najviac 10 krajín v rámci roka alebo rozsahu dátumov. Každý sviatok uvádza, či ide o deň voľna, bankový sviatok alebo či spadá do školských prázdnin, či sa sviatok vo víkende presunul na iný deň, či je dátum podľa islamského kalendára stále odhadovaný, a či sa v daný deň uplatňuje zákaz jazdy nákladných vozidiel (truck_ban). Filtrovať možno podľa regiónu (region=DE-BY), typu, jazyka a názvu; school=1 pridá školské prázdniny.
• holiday-calendar-business-days (/api/v2/data/holiday-calendar/business-days) — počítanie pracovných dní medzi dvoma dátumami, pripočítanie alebo odpočítanie pracovných dní, overenie dátumu alebo nájdenie nasledujúceho či predchádzajúceho pracovného dňa. Využíva víkend danej krajiny (sobota-nedeľa, alebo piatok-sobota a iné víkendy v krajinách Perzského zálivu), celoštátne a regionálne dni voľna a presuny dní na základe nariadenia.
• holiday-calendar-countries (/api/v2/data/holiday-calendar/countries) — pokryté krajiny s víkendovými dňami, časovým pásmom, regiónmi a typmi sviatkov; s parametrom country= aj počet pracovných dní v roku a nasledujúcich päť sviatkov.
• holiday-calendar-impact (/api/v2/data/holiday-calendar/impact, plán Pro a vyšší) — modelovo odhadovaný obchodný vplyv: skóre vplyvu 0-100 pre každý sviatok, pravdepodobnosť zatvorenia obchodov, kategórie dopytu, poloha v predĺženom víkende a v premostení a okná nárastu dopytu. V produkte holiday-calendar-holidays získavajú plány Pro a vyššie tento blok tiež pomocou include=impact a môžu filtrovať pomocou min_impact.

Existujúci produkt holiday-calendar sa nemení. Dokumentácia: Holiday Calendar.

Tri nové produkty na zabezpečenie súladu s predpismi o čase jazdy, poskytované z /api/v2:

• fleet-compliance-validate (POST /api/v2/data/fleet/compliance/validate, telo JSON) — kontroluje zaznamenanú aktivitu vodiča podľa EU 561/2006 alebo AETR a pracovného času podľa Directive 2002/15/EC. Vracia každé porušenie s článkom pravidla a pásmom závažnosti, ako aj to, čo vodičovi zostáva: denná jazda, kĺzavé týždenné limity 56 h a dvojtýždenné limity 90 h, nasledujúca prestávka, denný a týždenný odpočinok. Pokrýva rozdelené prestávky, skrátené a predĺžené dni, kompenzáciu skráteného týždenného odpočinku, nočnú prácu, dvojčlennú posádku a prerušený odpočinok na trajekte alebo vo vlaku.
• fleet-compliance-limits (/api/v2/data/fleet/compliance/limits) — parametre pravidiel pre EU 561, AETR (s jeho rozdielmi oproti 561) a 2002/15, ako aj pásma závažnosti podľa Regulation (EU) 2016/403.
• fleet-compliance-plan-check (POST /api/v2/data/fleet/compliance/plan-check, telo JSON) — kontroluje plánované zmeny pred expedíciou voči zákazom jazdy nákladných vozidiel, štátnym sviatkom a víkendovým dňom v krajinách trasy a voči pravidlám EU 561, AETR a 2002/15. Každá zmena dostane najskorší zákonný čas začiatku.

Dokumentácia: Fleet Compliance.

Od v3 majú zastávky denného a týždenného odpočinku polia in_vehicle_allowed, accommodation_required a rule (route-plan s rest_rules=eu561 a truck-route). Nariadenie (EÚ) 2020/1054 zmenilo čl. 8 ods. 8 EU 561/2006: pravidelný týždenný odpočinok a žiadny týždenný odpočinok dlhší ako 45 h sa nesmie čerpať vo vozidle. Pre tieto zastávky je in_vehicle_allowed = false. Skrátený týždenný odpočinok (od 24 h do menej ako 45 h) a denný odpočinok sa môžu čerpať v stojacom vozidle s miestom na spanie.

Zastávky týždenného odpočinku majú aj accommodation[] — parkoviská s izbami na mieste blízko zastávky — a parkovisko zastávky má has_accommodation. Je to len informácia: zastávka, jej čas a parkovisko pre kamióny sa nemenia. Ak nie je známe miesto s izbami, zastávka má warning = no_accommodation_found. Odpovede v1 a v2 sa nemenia.

Ceny staníc v /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest, /api/v2/data/fuel-local a /api/v2/data/fuel s mode=nearest majú teraz maximálny vek 90 dní. Cena, ktorú sme naposledy potvrdili pred viac ako 90 dňami, sa už nevracia. Predtým sa taká cena vracala s stale = true.

Čo sa mení v odpovediach: druh paliva, ktorý má iba staršiu cenu, chýba v prices; stanica bez akejkoľvek ceny nie je uvedená alebo má prázdny objekt prices tam, kde sa zobrazujú stanice bez cien; a odpoveď môže byť prázdna tam, kde predtým obsahovala staré ceny. Prázdna odpoveď ako doteraz obsahuje empty_reason. fuel-local potom môže odpovedať z úrovne regiónu alebo krajiny. Príznak stale sa nemení: je true, keď bola cena naposledy potvrdená pred viac ako 7 dňami. História cien sa uchováva. Pre fuel-cities, fuel-cost, celoštátne priemery a fuel-grades nie je žiadna praktická zmena. Podrobnosti: Vek ceny.

GET /api/v2/data/route-plan získava vo v2 rozšírený model zastávok (len doplnky: nič sa neodstránilo ani nepremenovalo) a nové predvolené hodnoty vo v3 (/api/v3/data/route-plan).

v2, doplnok. So stop_places=1 každá zastávka (prestávka, jedlo, nocľah, týždenný odpočinok) obsahuje places[]: kandidátske parkoviská v okne jazdného času okolo zastávky, každé s poľami name, type, country, lat, lon, at_km, at_drive_s, offset_min, off_route_km, detour_km, exceeds_4h30 a type_rank. Vyhľadávanie doladíte cez places_before_min, places_after_min, places_radius_km a rest_radius_km; polomer nad 25 km sa obmedzí a nahlási upozornením radius_clamped. rest_rules=legacy|eu561 vyberá model odpočinku a s eu561 môžete poslať stav vodiča: driven_since_break_min, driven_today_min, duty_started_min_ago, driven_week_min, driven_fortnight_min, extended_days_used, reduced_rests_used a allow_reduced. Nové typy zastávok: ban_wait (s ban: name, country, from, until) a weekly_rest; čakanie, ktoré nahrádza prestávku alebo odpočinok, je označené counts_as. Hraničné priechody pre nákladné vozidlá pri výjazde z Ukrajiny s elektronickým radom pridávajú registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note a registration_url a upozornenia echerha_registration a echerha_wait_unverified.

v3, nové predvolené hodnoty. rest_rules má predvolene hodnotu eu561; názvy miest sú prísne (len skutočné parkoviská a oddychové zóny); čas čakania zverejnený eCherha (čerstvé údaje, bez limitu) sa používa ako čakanie na hranici a čakanie na hranici sa započíta ako prestávka alebo odpočinok, ktorý bol splatný. v2 zachováva starý model odpočinku a pôvodný filter miest, takže existujúce integrácie sa nemenia. Podrobnosti: Route Planner API.

GET /api/v3/data/truck-route teraz používa čakanie na hranici z eCherha. Vo v3 border_crossings[] pre nákladné pruhy pri výjazde z Ukrajiny s elektronickým radom preberajú wait_min zo zverejneného času čakania eCherha (len čerstvé údaje, bez limitu; pri zastaraných údajoch je wait_min null a pridá sa upozornenie echerha_wait_unverified) a obsahujú registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note a registration_url, s upozornením echerha_registration.

Plán odpočinku berie čakanie na hranici ako čas strávený na hranici: dlhý rad sa započíta ako prestávka, denný alebo týždenný odpočinok, ktorý bol splatný (counts_as v riadku waits[]), namiesto toho, aby sa pripočítal navyše. v2 je nezmenená. Podrobnosti: Truck Route API.

Keď /api/v2/data/fuel-stations alebo /api/v2/data/fuel-cheapest nenájde žiadnu stanicu, odpoveď má stále HTTP 200 s prázdnym zoznamom a teraz uvádza dôvod. Iba pri prázdnej odpovedi obsahuje data polia empty_reason (no_station_in_radius, no_price_for_fuel_type, fuel_type_not_priced_in_country, unknown_fuel_type alebo no_fresh_price_in_radius), nearest_station_km (najbližšia stanica s vaším typom paliva, hľadá sa do nearest_search_km = 50 km; null, ak žiadna nie je), country a suggestion, jednu krátku vetu vo vašom lang, napríklad: No station within 5 km — the nearest is 6.4 km away; try radius_km=10.

Vetvte kód podľa empty_reason a nearest_station_km. suggestion je rada pre ľudí a jej znenie sa môže zmeniť. Okruh za vás nikdy nezväčšujeme. Ak vzorkujete oblasť alebo trasu v mriežke, použite radius_km 10–15. Odpovede so stanicami sa nemenia. Podrobnosti: Prázdne odpovede.

Polomer vyhľadávania. radius_km na /api/v2/data/fuel-stations teraz zachováva jedno desatinné miesto. Polomer ako 4.8 sa predtým bez upozornenia skrátil na 4, takže každé vyhľadávanie pokrylo až o tretinu menšiu plochu, než sa žiadalo, a mohlo vrátiť menej staníc alebo žiadnu. anchor.radius_km ukazuje skutočne použitý polomer; celé čísla sa vracajú ako doteraz.

Názvy značiek. Rovnaká značka sa v brand teraz vždy píše rovnako — napríklad ORLEN a orlen sa vracajú ako Orlen a CircleK ako Circle K. Stanice, ceny, id a polia sa nemenia. Ak značky porovnávate podľa presného pravopisu (pre loga alebo filtre), skontrolujte svoj zoznam voči novým názvom.

GET /api/v2/data/truck-route prijíma nový voliteľný parameter traffic. Určuje, ako sa pri ETA, pláne odpočinku, časoch príchodu na hranice a časoch pri zákazoch pre nákladné vozidlá zohľadňuje doprava:

• forecast (predvolené): opakujúce sa zápchy v hodine, keď kamión prechádza jednotlivými úsekmi, aktuálne kolóny slabnúce s časom do príchodu, výluky a uzávierky na trase a počasie, ak ho máme. Odpoveď obsahuje blok traffic_forecast s oneskorením rozdeleným podľa príčin.
• live: iba aktuálna doprava, bez opakujúcich sa zápch.
• off: bez úpravy podľa dopravy; časy sú časy plynulej jazdy podľa enginu pre nákladné vozidlá. traffic_forecast potom obsahuje iba model a mode.

Každá iná hodnota vráti 400 bad_request so správou Invalid traffic: forecast, live or off. Požiadavky bez parametra dostanú predvolenú hodnotu forecast.

Zákazy pre nákladné vozidlá v prognózovanom čase príchodu: pri forecast alebo live sa truck_bans[].active teraz posudzuje v čase, keď má kamión podľa prognózy dosiahnuť daný zákaz (od depart_at, alebo od teraz, ak ho neposielate), pred prípadným čakaním na tento zákaz. Nové pole truck_bans[].active_at udáva posudzovaný čas v miestnom čase krajiny zákazu. bans_summary, restriction_hits a legal sa riadia rovnakými verdiktmi a zákaz, do ktorého prognózované oneskorenie novo narazí (napríklad v ďalší deň alebo v inej krajine), sa tiež uvádza v truck_bans. Pri traffic=off sa active posudzuje na časovej osi plynulej jazdy a active_at sa rovná eta_at_ban.

Nový produkt: Truck Route API (GET /api/v2/data/truck-route, iba v2). Jedno volanie vráti trasu povolenú pre nákladné vozidlo a všetko, čo dispečer potrebuje popri nej. Trasu počíta rovnaké routovacie jadro ako naša navigačná aplikácia pre nákladné vozidlá TruckTurn, nad našimi vlastnými mapovými dátami.

• Vozidlo: height, width, length, weight, axle_load, axles, trailers, emission_class, hazmat (triedy ADR) a adr_tunnel (B–E). Zákazy jazdy nákladných vozidiel a obmedzené zóny sa kontrolujú na vrátenej trase.
• Pozdĺž trasy: čerpacie stanice s aktuálnymi cenami, parkoviská pre nákladné vozidlá a vážne stanice, každé s km_from_start a obchádzkou.
• Plán odpočinku vodiča podľa nariadenia EÚ 561/2006: prestávky (vrátane delených 15+30), denný a týždenný odpočinok (vrátane skráteného), jeden vodič alebo dvojčlenná posádka (crew=2), počnúc aktuálnym stavom vodiča, ak ho odovzdáte. Každá zastávka je umiestnená na skutočnom parkovisku pozdĺž trasy. Ide o pomôcku na plánovanie, nie o záznam z tachografu.
• ETA vrátane odpočinku, zákazov jazdy nákladných vozidiel a čakania na hraniciach. Plánovanie podľa depart_at alebo arrive_at.
• Odhad nákladov na mýto podľa krajín (EUR, podľa počtu náprav a emisnej triedy); krajiny bez tarify sú uvedené v tolls.coverage_note. Ďalej avoid (mýto, trajekty, diaľnice, hranice, tunely, nespevnené cesty, nízkoemisné zóny), až 2 alternatívy, rozdelenie podľa krajín a geometry ako polyline5, polyline6 alebo GeoJSON.

Kvóta: samostatný limit pre trasy nákladných vozidiel: 10 volaní denne na každom účte, viac v platených plánoch, a doplnok Ďalšie volania trás pre nákladné vozidlá. V sandboxe môžete denne vypočítať 10 trás pre nákladné vozidlá, zobraziť výsledok na mape s úplným plánom trasy a exportovať ho do GPX, KML, GeoJSON, CSV, kalendára (.ics) alebo ITN. Pozri stránku produktu a referenciu.

Podľa Podmienok API je Market krajina, ktorej dáta používate, a váš kľúč pokrýva krajiny schválené pre váš účet. Doteraz produkty založené na súradniciach (lat/lon — napr. Nearby Shops, Truck Parkings, Fuel Stations) odpovedali pre akýkoľvek bod v Európe. Od 13. októbra 2026, sa to kontroluje pri spracovaní vašej požiadavky:

• Požiadavka, ktorej lat/lon leží v krajine, ktorá nie je schválená pre váš účet, vráti 403 s error.code market_not_allowed. Správa uvádza krajinu a váš zoznam schválených krajín.
• Ak polomer prekročí hranicu, výsledky, ktorých country_code je mimo vašich schválených krajín, sa odstránia. Odpoveď potom obsahuje markets_filtered (koľko bolo odstránených) a markets_notice, pričom total_found počíta len prijaté výsledky.

Toto sa vzťahuje na účty, ktorých krajiny boli overené (stav approved alebo partial). V požiadavke sa nič nemení — žiadny nový parameter, žiadna nová verzia. Ak vaša aplikácia potrebuje ďalšiu krajinu, pridajte ju v portáli pre vývojárov pred 13. októbrom. market_not_allowed je uvedený spolu s ostatnými chybovými kódmi v referencii.

Vývojárske účty prepojené s účtom Nakordoni Partners s rovnakou e-mailovou adresou môžu teraz odosielať správy a spravovať svoju flotilu NakBus (NakDriver / NakManager) na stránke partners.nakordoni.eu, s tímovými rolami (Owner, Manager, Viewer) a prihlásením jedným kliknutím medzi oboma portálmi. Stránky portálu pre vývojárov, API kľúče, koncové body flotily a aplikácie zostávajú bez zmien.

Pri Fuel Prices bežali updated_at a vlastný príznak age_hours/stale v odpovedi podľa rôznych hodín: updated_at sa mení, len keď sa cena skutočne zmení, ale zastaranosť sa počítala, ako keby sa menilo pri každom potvrdení. Pri 46.7% cenového indexu bolo age_hours ≤48 a stale:false, hoci updated_at bolo v skutočnosti staršie ako 48 hodín, pri 12,620 staniciach staršie ako týždeň. Každá cena teraz navyše nesie confirmed_at — čas posledného potvrdenia ceny, zaokrúhlený nadol na hodinu a nikdy skorší ako updated_at — a age_hours/stale sa počítajú z neho. Význam updated_at sa nemení: použite ho, keď chcete vedieť, kedy sa cena naposledy pohla, a confirmed_at, keď chcete vedieť, aká je aktuálna práve teraz. V zamrznutom kontrakte v1 nie je prítomné.

Dve jazykové chyby, obe tiché: zaslanie kanonického kódu druhu paliva s lang=pl (alebo ktorýmkoľvek z ďalších 24 jazykov webu) vracalo fuel_type_local po anglicky bez ohľadu na požiadavku — voči tabuľke popisov sa kedy kontrolovalo len 10 jazykov, takže všetko mimo tohto zoznamu spadlo na predvolený slovník rozhrania namiesto požadovaného jazyka. Osobitne lang=tr (alebo niekoľko ďalších platných kódov) vracalo zoznamy staníc po ukrajinsky, pretože interná predvolená hodnota uk sa uplatnila vždy, keď požadovaný jazyk nebol na tom istom zozname 10 jazykov. Oboje je opravené: jazyk, ktorý odošlete, je teraz jazyk, ktorý dostanete, vo všetkých 25.

Ďalej: brand pri Nearby Fuel Stations už pre ~330 staníc, ktorých značku nepoznáme, nevracia surovú hodnotu OTHER z načítania dát — je to null, zhodne s každým iným neznámym poľom v odpovedi.

Hraničný AI asistent (/api/v1/data/assistant) odpovedal 503 internal_error — „Asistent je dočasne nedostupný“ —, keď ten istý kľúč položil tú istú otázku dvakrát do piatich minút. Nič pritom nebolo nedostupné: vo väčšine týchto prípadov bola odpoveď už vypočítaná a pripravená na odovzdanie. Teraz sa vracia štandardne, s ok: true a HTTP 200.

Ak opakovanie príde v čase, keď sa prvá odpoveď ešte zapisuje, volanie teraz vráti 429 s error.code rovným duplicate_request namiesto 503, aby politika opakovaní odlíšila „opýtaj sa o chvíľu znova“ od skutočného výpadku. Oba prípady sa navyše počítali do chybovosti vášho účtu ako serverové chyby; už sa nepočítajú. Na samotnej požiadavke sa nič nemení — žiadny parameter, žiadna verzia. duplicate_request je v referencii uvedený spolu s ostatnými kódmi chýb.

Parkoviská pre kamióny (/api/v2/data/truck-parkings) vracali záznamy s name rovným null a prázdnou address — pri Bensheime 20 z 50. Sú to miesta, ktoré evidujeme len ako súradnicu: nie je čo zobraziť ani s čím spárovať vašu vlastnú sadu POI. Do tohto produktu už nepatria: vracia teraz iba pomenované lokality, v súčasnosti viac než 22 000 v celej Európe. Ak ste nepomenované záznamy filtrovali sami, taký kód je teraz zbytočný, ale neškodný. Odpovede sú pri rovnakom radius a limit kratšie a každý vrátený záznam je použiteľný.

Samostatne: približne 10 000 parkovísk malo v poli name surovú dvojicu súradníc, napríklad 51.927301,10.14112, kým skutočné označenie bolo v address. Teraz nesú toto označenie — Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — všade, kde sa objavujú, vrátane /api/v1/data/pois. id každého miesta sa nemení, takže uložené priradenie zostáva platné; mení sa iba name.

snapshot.updated_at v /api/v1/data/queue a /api/v1/data/multi je miestny čas v pásme samotného hraničného priechodu (napríklad Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv) a doteraz v odpovedi nikde nebolo uvedené, o ktoré pásmo ide, takže volajúci ho nedokázal previesť na konkrétny okamih. snapshot dostáva navyše pole timezone (názov IANA) vedľa updated_at. Žiadny parameter, žiadna verzia, žiadne iné zmeny polí.

Doteraz každý palivový endpoint opisoval vlastné pokrytie ručne písaným zoznamom: AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, pričom Poľsko v ňom bolo zúžené na oblasť Trojmestia. Obe tvrdenia už dávno neplatili. Pokrytie sa teraz meria zo živého indexu staníc a prepočítava sa každých šesť hodín: 39 krajín má dnes stanice s cenami a Poľsko medzi nimi na celom území, nie v troch mestách. Na samotnej požiadavke sa nemení nič: žiadny parameter, žiadna verzia.

Čerpacie stanice v okolí a Najlacnejšie palivo: keď hľadanie nevráti nič, blok coverage teraz nesie namerané station_countries, station_counts, sparse_coverage a measured_at, zúžené na požadovaný druh paliva, nie na palivo vo všeobecnosti. Krajina sa dostane do sparse_coverage, keď v nej máme 25 staníc s cenami alebo menej — je to počet, nie úsudok.

Pribudla nová poznámka pre druh, ktorý poznáme, ale ktorého cenu tam, kde sa pýtate, nikto neuvádza. Doteraz sa coverage.fuel_type_note objavovala len vtedy, keď nám bol neznámy samotný názov z výdajného stojana. Teraz sa objaví aj vtedy, keď sa názov rozpozná správne, no v tej krajine preň jednoducho niet ceny; pomenuje krajiny, kde je ten druh ocenený, aj druhy, ktoré oceňujeme vo vašom okolí. Český názov Natural 100 je čistý príklad: rozpozná sa, no v Česku naň žiadny zdroj neuvádza cenu. Prázdna odpoveď tak prestáva vyzerať ako pokazená požiadavka.

Druhy paliva (/api/v2/data/fuel-grades) dostáva priced_countries a priced_station_counts pre každý druh a navyše priced_here, keď pošlete ?country=. Tie dva zoznamy znamenajú niečo iné: krajina v countries je taká, kde tento názov zo stojana prijímame, kým priced_countries hovorí, kde ho zdroj naozaj ocení, takže priced_here s hodnotou 0 je skutočná odpoveď, nie medzera v odpovedi. Prichádzajú aj coverage_measured_at a coverage_note a Cache-Control klesá z 24 hodín na 6, aby zodpovedal frekvencii prepočtu.

Rozpoznáva sa aj viac miestnych názvov zo stojanov, medzi nimi Klimadiesel 90 (HVO100) a HVO Diesel, Erdgas a Metano, Autogas a Autogaz, DEF pre AdBlue, a tiež viacero značkových názvov prémiovej nafty a benzínov. Poradie rozpoznávania sa nezmenilo a porovnávanie ostáva presné, takže žiadny predtým fungujúci názov dnes neznamená niečo iné a nový názov môže nanajvýš zmeniť prázdnu odpoveď na odpoveď s cenami. Zároveň sme opravili referenčnú dokumentáciu a opisy endpointov vo všetkých 25 jazykoch stránky.

Najlacnejšie palivo (/api/v2/data/fuel-cheapest) vracalo najbližšie čerpacie stanice zoradené podľa vzdialenosti namiesto najlacnejších. Keďže sa zoraďovanie uplatňovalo skôr, než sa výsledok orezal na váš limit, najlacnejšie stanice vo vašom okruhu mohli z odpovede úplne chýbať. Zoraďovanie opäť funguje správne: najprv najnižšia cena pre požadovaný druh paliva, pri zhode ceny vyhráva bližšia stanica a stanica bez ceny pre daný druh sa ocitne na konci. Na samotnej požiadavke sa nič nemení — žiadny nový parameter, žiadna nová verzia.

Odpovede v2 pre palivo sú tiež zdokumentované presne tak, ako sa skutočne vracajú: stanice prichádzajú v data.stations[], jeden záznam na fyzickú stanicu, pričom každý druh paliva je vnorený v objekte prices (price, currency, local_name, updated_at, age_hours, stale) a ďalej station_ref, grades, total_found a notices. Referencia pre Čerpacie stanice v okolí a Najlacnejšie palivo stále opisovala starší plochý zoznam riadkov data.data[].

Na stránke platieb (mesačná karta) sú k dispozícii dva doplnky k ľubovoľnému plánu, bez jeho zmeny: Extra volania prognóz — +100 volaní prognóz a štatistík denne za blok, 2 € mesačne za blok, až 10 blokov; a Extra krajiny — +1 deklarovateľná krajina za kus, 2 € mesačne za každú. Pri zmene počtu sa zobrazí presná pomerná kalkulácia ešte pred stiahnutím peňazí.

Od 10. novembra 2026 každý plán zahŕňa daný počet deklarovaných krajín: Explorer a Student 4, Starter 10, Pro a vyššie bez obmedzenia. Od tohto dátumu nebude možné uložiť deklaráciu dlhšiu, než je plán plus zakúpené extra krajiny; karta Účet už zobrazuje váš limit a účty, ktoré ho prekračujú, vidia odporúčanie na nástenke. Pred 10. novembrom sa nič nemení.

API sandbox teraz označuje každý endpoint vo výbere jeho triedou kvóty (Ťažký / Štandardný), zobrazuje náklady na kvótu pre zvolenú verziu ešte pred spustením a po volaní ukazuje, koľko by to isté volanie stálo z vašej ostrej kvóty — vrátane vzorca ceil(N ppids × M sub-products / 2) používaného pri volaniach typu /multi.

Ide o náhľad len na čítanie: samotné volania v sandboxe sa strhávajú z oddeleného testovacieho rozpočtu sandboxu, nikdy z vašej ostrej kvóty.

Od dnešného dňa je všetko, čo sme verejne ohlásili ako vyraďované, uzavreté pre vývojárske účty vytvorené v deň ohlásenia alebo neskôr. Ak váš účet existoval pred ohlásením, nič sa nemení — zachovávate si celé prechodné obdobie až do dátumu vyradenia uvedeného v zázname, ktorý ho ohlásil.

Prečo toto pravidlo existuje. Dňa 24. augusta 2026 sme ohlásili, že truck-bans v1 sa vyradí 8. septembra 2026. Dva účty sa zaregistrovali niekoľko dní po tomto ohlásení, postavili svoju integráciu na v1 a boli pár hodín od 410 bez toho, aby k nim dorazil čo i len jeden náš e-mail: ohlásenie aj dávka notifikácií predchádzali ich registrácii. Nič v API im nezabránilo nasadiť verziu, o ktorej sme už povedali, že končí. To bolo naše zlyhanie a toto je náprava — nemôžete nanovo nasadiť niečo, čo je už naplánované na odstránenie.

Ako to vyzerá. Takéto volanie je odmietnuté s 410 Gone a chybovým kódom version_closed_to_new_accounts. Správa uvádza dátum vyradenia, dátum ohlásenia a verziu, ktorú použiť namiesto nej. Ide zámerne o iný kód než version_sunset, ktorý dostane každý účet po tom, ako samotný dátum vyradenia uplynie — podpora tak rozozná „prišli ste príliš neskoro na to, aby ste začali“ od „toto je preč pre všetkých“ bez čítania logu.

Zachovanie prístupu sa riadi dátumom vytvorenia účtu, nie prvým volaním. Ak ste sa zaregistrovali pred ohlásením, ale integrovať začínate až teraz, stále dostanete celé prechodné obdobie: mohli ste na tom stavať celý čas.

Platí od teraz pre truck-bans v1 (ohlásené 24. augusta 2026, vyradenie 8. septembra 2026) a automaticky pre každé vyradenie, ktoré od tejto chvíle ohlásime. Nič nové sa od vás nevyžaduje: každá odpoveď na vyraďovanej verzii už nesie hlavičky Deprecation, Sunset a Link: rel="successor-version", takže nová integrácia vidí blížiace sa vyradenie aj bez čítania tejto stránky.

Nadviazanie na včerajšiu zmenu vo v4 (vývojársky tiket #105). Zoznamy destination oddelené čiarkami vo v1 a v2 naďalej fungujú, ale teraz podliehajú rovnakému termínu ako destination=all: oboje končí 2026-10-06 (dovtedy hlavičky Deprecation/Sunset, potom 400 destination_list_removed s uvedením /api/v4/ ako náhrady). Existujúca kontrola limitu 10 položiek pri zoznamoch s čiarkami sa do tohto dátumu nemení.

v4 zostáva pri jednom cieli na volanie — to sa dnes nezmenilo. Zmenilo sa len to, ako komunikujeme v1/v2: chyba 400 pri destination=all už neponúka zoznam s čiarkami ako cestu migrácie (skončil by k rovnakému dátumu), ale smeruje priamo na v4.

Oprava dokumentácie: príklad v4 na tejto stránke predtým znel /api/v4/data/border/1/2,3,4/9 — čo je zoznam s čiarkami, ktorý v4 odmieta. Teraz je to /api/v4/data/border/1/2/9. Kto starý príklad skopíroval, dostal by pri prvom volaní 400; ospravedlňujeme sa.

Nový preložený kľúč product_border_v4_p_destination vychádza vo všetkých 25 jazykoch webu a výslovne uvádza pravidlo jedného cieľa vo v4 namiesto preberania formulácie z v1/v2.

/api/v4/data/border/{origin}/{destination}/{crossing_type} je od dnes v prevádzke. Oproti v2 sa menia tri veci a spoločne sú dôvodom, prečo ide o novú verziu, a nie o úpravu.

1. Koniec destination=all. Naše dáta sú licencované po krajinách (Developer API Terms, oddiel 7) a zástupný symbol, ktorý sa rozvinie na „každého suseda, pre ktorého máme dáta“, vracia krajiny, pre ktoré váš účet nemusí byť schválený — a v požiadavke to nie je nijako vidieť. Vo v4 krajinu pomenujete.

2. Jedna cieľová krajina na volanie. /api/v4/data/border/1/2/9 sa pýta na jednu hranicu. Zoznamy oddelené čiarkou sa neprijímajú: 1/2/9, 1/3/9 a 1/4/9 pošlite ako samostatné volania. Zoznam s čiarkou alebo all odpovie 400 a vymenuje presné volania, ktoré treba poslať, takže nič nezlyhá potichu.

3. Jeden kód pre nákladnú dopravu. v1 a v2 delili nákladnú dopravu na 8 (Freight Transport) a 9 (Freight Transport up to 7.5 t). Toto delenie na priechode reálne existuje, ale žiadny integrátor s ním nedokáže pracovať: požiadavka na 9 vo v2 na hranici UA-PL vrátila 21 zo 70 nákladných priechodov a nič to nenaznačilo. v4 odpovedá na 9 všetkými nákladnými pruhmi a 8 prijíma ako alias pre 9. Každý riadok nesie vlastný crossing_type, takže zlúčená odpoveď zostáva preskúmateľná.

Vo v1 a v2 destination=all funguje ďalej do 6. 10. 2026 a dovtedy nesie hlavičky Deprecation / Sunset. Od tohto dátumu odpovedajú aj tieto verzie na all chybou 400 — zvyšok v1 a v2 zostáva nedotknutý a naďalej dostupný. Rovnaký dátum platí pre ostatné skratky pre všetky krajiny: travel-matrix bez ?dest=, bus-carriers s ?ppid=all a fuel-grades bez ?country=.

v3, ohlásená dnes skôr, je nahradená verziou v4. v3 sa od v4 líšila len tým, že stále prijímala zoznam oddelený čiarkou, a žiadna integrácia tento tvar nepoužíva. URL adresy v3 naďalej odpovedajú, takže sa nič, čo bolo napísané voči nim, nerozbije, ale v3 nie je zdokumentovaná a nebude sa ďalej vyvíjať — prejdite na v4.

Všetko ostatné vo v4 je ako vo v2: smerové poradie v ceste, direction{from,to}, stale a ?max_age_min=.

Číselné ID v /border/{origin}/{destination}/{crossing_type} neboli nikdy zverejnené ako tabuľka, takže si ich integrátori rekonštruovali z časových pásiem a ukážkových URL adries. Teraz sú v dokumentácii pod Kódy krajín a typov vozidiel, vykreslené z tých istých tabuliek, voči ktorým API validuje — ID krajín aj s hranicami, na ktoré sa každé rozvinie, a každý crossing_type s označením, ktoré API vracia.

Pri ich zverejňovaní sme zistili, že sandbox a metadáta endpointu popisujú 8 ako „truck<7.5t“ a 9 ako „truck“. Je to naopak: API označuje 8 ako Freight Transport a 9 ako Freight Transport up to 7.5 tons, a vždy to tak bolo. Ak ste kód pre nákladnú dopravu vybrali podľa nápovedy parametra, filtrovali ste opačný pruh, než ste zamýšľali. Opravené všade a v3 túto voľbu odstraňuje úplne.

API Terms v1.1 nahrádzajú v1.0 ešte pred nadobudnutím jej účinnosti a platia od 6. 10. 2026. Prijmite ich, prosím, vo svojom dashboarde.

Oddiel 7 teraz hovorí, čo je Trh: krajina, ktorej dáta používate — teda kde leží priechod alebo hranica, na ktorú sa pýtate — nie krajina, v ktorej žijú vaši používatelia. Náš dashboard uvádzal na rôznych miestach obe možnosti; vynucovanie vždy znamenalo tú prvú.

Dve zmeny vo váš prospech. Krajiny už schválené pre váš účet zostávajú použiteľné, kým sa posudzuje neskoršia zmena (pridanie krajiny už nepozastavuje tie, ktoré máte). A ak sme na deklaráciu trhu neodpovedali do 5 pracovných dní, do našej odpovede platia plné limity vášho plánu.

Oddiel 10.3 teraz zodpovedá tomu, čo dashboard skutočne vyžaduje, a oddiel 13.2 uvádza základ dostupnosti, ktorý meriame a vieme vám ho ukázať.

Tri produkty teraz nesú doplnkové pole data_quality (high alebo low), ktoré označuje, či je hodnota reálnym pozorovaním, alebo modelovým odhadom bez živého zdroja počítania na danom priechode: queue (na najvyššej úrovni v snapshot a na každom historickom riadku v data[] — na riadkoch prognózy chýba), update-info (na obálke) a multi (na podobjektoch queue aj update_info pre každý priechod). Nejde o nový signál — príznak už interne existoval — ale nikdy nebol vystavený, takže plne modelovaný priechod vyzeral rovnako ako priamo meraný. is_realtime je zámerne nezmenené: pre modelované riadky naďalej vracia true a zmena tohto významu je zásadná zmena na úrovni v2, ktorú tu nerobíme.

Tiež z tohto vydania: produkt queue-advanced už ďalej nešíri surové počasie z upstreamu. weather_main, temperature a wind_speed nahrádza odvodený condition_code (stupnica rizika 0–5, null, keď počasie nie je k dispozícii), condition a severity.

Od 2026-08-30 sa jedna požiadavka /api/v1/data/multi zodpovie najviac pre 5 hraničných priechodov. Volanie, ktoré uvádza viac PPID, nie je odmietnuté: naďalej vráti 200, ale odpoveď sa poskytne len pre prvých 5 ID v ?ppids=. Ostatné ID sa ignorujú, vrátia sa v meta.ppid_cap.ignored a neúčtujú sa z vašej kvóty — volanie sa spoplatňuje podľa toho, čo skutočne vráti.

Kým volanie prekračuje limit, odpoveď obsahuje hlavičku X-Devapi-Warning: multi_ppid_cap a blok meta.ppid_cap s poľami cap, enforced_from, enforced, ppids_asked, ppids_answered a ignored[]. Do 2026-08-30 sa tieto polia zobrazujú s hodnotou enforced: false a s úplnou množinou výsledkov, takže prichádzajúcu zmenu uvidíte vo vlastných logoch.

Zľava z kvóty vo výške polovice zostáva nezmenená. Rozdeľte si hraničné priechody do skupín po 5 a v bežnom cykle obnovovania posielajte jedno volanie na skupinu; pri častom dopytovaní len na dĺžku radu a aktuálnosť údajov zostáva lacnejším produktom štandardnej triedy update-info.

Vypočítaný ukrajinský horúčavový zákaz — vracaný s include_ua_heat a pri country=UA automaticky — teraz odpovedá za rozsah dátumov, na ktorý sa pýtate. Predtým vracal najbližších sedem dní bez ohľadu na date_from a date_to, takže decembrové okno ticho vrátilo riadky tohto týždňa. Zákaz sa počíta z predpovede počasia, nečíta sa z kalendára zákazov, a má preto dve hranice, ktoré kalendár nemá: nepozerá sa dozadu a končí tam, kde končí predpoveď. Váš rozsah sa teraz pretína s tým, čo predpoveď skutočne pokrýva, a nové pole ua_heat_ban.forecast_horizon uvádza posledný dostupný dátum. Rozsah za týmto horizontom nevráti žiadne riadky a dôvod vysvetlí v summary — to nie je to isté ako „žiadny zákaz“. Odpovede v1 sa nemenia.

Tvar odpovede nebol doteraz nikde opísaný — jediný spôsob, ako zistiť, čo produkt vracia, bolo zavolať ho. Na stránke každého produktu je teraz pod tabuľkou parametrov tabuľka Polia odpovede s krátkym opisom každého poľa; polia prvkov zoznamu sa zobrazujú ako items[].name, polia na úrovni obálky (usage, meta, snapshot, resolved_location) bez predpony. Opísaných je 40 zo 42 produktov: dva zatiaľ nespustené (weather, road-quality) zámerne zostávajú bez opisu. Rovnaká tabuľka sa publikuje aj do nášho verejného zrkadla dokumentácie na GitHube.

Každý palivový produkt teraz prijíma miestny názov druhu paliva, nielen náš interný zápis: ON v Poľsku, Nafta v Česku, Gázolaj v Maďarsku, Motorină v Rumunsku, ДП na Ukrajine, Motorin v Turecku, Gasóleo v Portugalsku a Španielsku. Názov sa vyhodnocuje najprv podľa krajiny — „95“ je E10 na dánskom stojane a E5 na poľskom — preto posielajte country spolu s miestnym názvom alebo súradnice, podľa ktorých vieme bod umiestniť. V odpovedi sa vracia fuel_type (kanonický), fuel_type_requested (presne ako ste ho napísali) a fuel_type_local. Názov, ktorý nevieme umiestniť, nikdy nenahrádzame predvoleným druhom: odpoveď príde prázdna a otvorene to povie.

Celá tabuľka je teraz samostatný produkt — GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON] — naše kanonické druhy paliva a ich miestne názvy v 41 európskych krajinách vrátane trhov, pre ktoré ceny neuvádzame. Krajinná a regionálna úroveň produktov fuel a fuel-local navyše dostala objekt grades, ktorý každý cenový kľúč priraďuje k druhu paliva a jeho názvu na stojane.

Produkt truck-bans teraz odpovedá na konkrétny dátum alebo rozsah dátumov na adrese /api/v2/data/truck-bans. Doteraz vždy vracal najbližších 7 dní a odoslaný dátum ignoroval, takže na zostavenie kalendára bola potrebná jedna požiadavka na každý deň — a pri pláne s dvoma požiadavkami za sekundu je väčšina z nich odmietnutá s 429 qps_exceeded.

Použite ?date=YYYY-MM-DD pre jeden deň alebo ?date_from= a ?date_to= pre rozsah. Obe hranice sú vrátane a ktorúkoľvek možno vynechať: začiatok je predvolene dnešok, koniec je začiatok plus 7 dní. Okno môže pokrývať najviac 92 dní — dlhšie je odmietnuté s 400 date_range_too_long, namiesto toho, aby sa potichu skrátilo. Ide o kalendár orientovaný dopredu: okno môže začínať najviac 7 dní dozadu a staršie dátumy sú odmietnuté, nie poskytnuté — pokrytie siaha dopredu do 31. decembra 2028 v 23 krajinách.

Každá odpoveď teraz obsahuje objekt window, ktorý pomenúva presne pokrytý rozsah. Ide o doplnkové pole a posiela sa aj vo v1, pričom v1 si zachováva svoje nemenné 7-dňové okno. Pozor: include_ua_heat vždy pokrýva najbližších 7 dní bez ohľadu na požadované okno — počíta sa z predpovede počasia, nie z kalendára zákazov. Pripomíname, že v1 tohto produktu končí 8. septembra 2026.

Dve súvisiace vylepšenia v celom API: každý parameter, ktorý produkt neprijíma, je teraz uvedený v poli ignored_params v odpovedi namiesto tichého zahodenia, a chyby validácie z dátovej služby sa k vám dostanú v pôvodnom znení, so strojovo čitateľným kódom v error.reason.

Tri opravy kvality odpovedí z auditu brány (tiket #43).

Hlavička X-API-Key je teraz akceptovaná popri Authorization: Bearer a ?key=. Ak váš HTTP klient posiela kľúče cez hlavičku s názvom X-API-Key, teraz to funguje — predtým bola potichu ignorovaná a volanie bolo odmietnuté ako missing_api_key. Authorization: Bearer zostáva zdokumentovanou a odporúčanou formou.

Chybová správa pri chýbajúcom kľúči teraz pomenúva všetky tri spôsoby autentifikácie (hlavička Bearer, hlavička X-API-Key alebo ?key=) namiesto toho, aby len odkazovala na registračnú stránku.

Adresár checkpoints teraz obsahuje has_day_stats v každom riadku — aditívny boolean, ktorý hovorí, či má API Best Time to Cross (day-stats) dáta pre daný hraničný priechod. Day-stats existujú len pre časť monitorovaných priechodov; skontrolujte tento príznak pred dopytovaním, aby ste sa vyhli predvídateľným 404. Existujúce polia sa nemenia.

V dokumentácii bolo tiež opravené: produkt road-conditions vždy rešpektoval parameter lang na lokalizáciu popiskov — len nebol uvedený.

Dve opravy a jedna nová verzia produktu truck-bans.

Krajiny oddelené čiarkou teraz fungujú. ?country= prijíma zoznam až 3 kódov ISO-2, napríklad ?country=DE,RO. Dlhší zoznam je odmietnutý s 400 too_many_countries, namiesto toho, aby bol potichu skrátený — ide o kalendár zákazov pre jednotlivé krajiny, nie o hromadný feed. Predtým to nefungovalo: oddeľovač sa odstránil, takže DE,RO sa čítalo ako jediný token DERO, nezhodovalo sa s ničím a vrátilo success: true s total_bans: 0 — sebavedomé „žiadne zákazy“ pre dve krajiny, ktoré ich spolu mali 22. Ak ste to obchádzali jednou požiadavkou na krajinu, jediná požiadavka teraz pokryje všetky a stojí jedno volanie namiesto viacerých.

Odpovede teraz hlásia vlastnú úplnosť. Tri aditívne polia — returned, total_available a truncated — vám povedia, či bola odpoveď orezaná. Predovšetkým volanie bez rozsahu vracia orezanú časť a doteraz to nič v tele odpovede neuvádzalo. total_bans si zachováva doterajší význam (riadky v tejto odpovedi), takže nič, čo už parsujete, sa nemení.

v2 je vymedzená na jednu krajinu. Na /api/v2/data/truck-bans je ?country= povinný a požiadavka bez rozsahu je odmietnutá s 400 scope_required — tento produkt je kalendár zákazov pre jednotlivé krajiny, nie hromadný feed. v1 je dnes nezmenená — stále prijíma volanie bez rozsahu a stále vracia rovnakých orezaných 50 riadkov ako doteraz, takže nič, čo vám beží, sa práve teraz nerozbije. v1 tohto produktu končí 8. septembra 2026. Do 7. septembra funguje normálne; od 8. septembra je požiadavka na v1 odmietnutá s 410 Gone a správou odkazujúcou na v2. Dovtedy každá odpoveď v1 nesie Deprecation: true, hlavičku Sunset s týmto dátumom a hlavičku Link s názvom nástupníckej verzie, takže klientska knižnica môže termín zobraziť bez toho, aby ktokoľvek čítal túto stránku. Migrácia: zmeňte segment verzie na /api/v2/data/truck-bans a odovzdajte ?country=.

Jedna oprava dokumentácie: parameter date bol odstránený. Bol dlho uvádzaný, ale služba ho nikdy nečítala, takže každá požiadavka, ktorá ho posielala, potichu dostala predvolené 7-dňové okno namiesto dňa, o ktorý žiadala. Na výber dňa filtrujte pole upcoming_bans podľa jeho poľa date. Kód ISO-3 ako DEU sa už tiež nepremieta na názov krajiny v súhrne, kde produkoval zavádzajúce „No truck ban data for: Germany.“

Produkt truck-bans teraz vracia celoštátne dopravné obmedzenia pre ďalších päť krajín: Belgicko (BE), Bielorusko (BY), Čierna Hora (ME), Severné Macedónsko (MK) a Švédsko (SE). Existujúce pokrytie Bulharska, Grécka a Portugalska sa rozšírilo a obnovilo — grécke obmedzenia teraz siahajú do septembra 2027 a Portugalsko je opäť naplnené.

Štruktúra odpovede sa nezmenila. Nové riadky nesú rovnaké kľúče ako každý iný zákaz: date, time_from, time_until, restriction_type, restriction_details, min_weight_tons a details_url. Ak obmedzenie platí len za určitej podmienky — bieloruské letné zákazy platia napríklad nad 25 °C — táto podmienka je uvedená v restriction_details, preto si toto pole prečítajte skôr, než upozorníte vodiča. min_weight_tons je null, keď sa pravidlo týka triedy prepravy (nebezpečný tovar), a nie tonáže.

Produkty fuel-stations a fuel-cheapest teraz vracajú ceny jednotlivých staníc v Poľsku. Pokrytie je čiastočné — oblasť Trojmestia (Gdansk, Gdyňa, Sopoty) — preto je Poľsko uvedené v novom doplnkovom poli coverage.sparse_coverage popri existujúcom zozname coverage.station_countries. Krajina uvedená v sparse_coverage má údaje o staniciach len pre časť svojho územia; dopyt inde v tejto krajine vráti prázdny zoznam spolu s poznámkou o pokrytí, presne ako doteraz. Poľské ceny sú uvádzané v PLN.

Chybová správa pri hromadnom dopyte je tiež jasnejšia: ak chýba lat, správa scope_required teraz odkazuje na produkt fuel (?country=XX) pre celoštátne priemerné ceny.

GET /api/v2/data/fuel-local?lat=&lon= teraz určuje cenu na troch úrovniach namiesto dvoch: station, potom region, potom country. Nová stredná úroveň existuje pre Ukrajinu, kde ceny jednotlivých staníc nie sú nikde: bod na Ukrajine teraz dostane priemer svojej oblasti namiesto celoštátneho priemeru a na celoštátny priemer sa vráti len vtedy, keď pre oblasť nie sú kotácie.

Odpoveď úrovne region obsahuje kód oblasti (hodnota ISO 3166-2, napríklad UA-46), region_name a region_center_dist_km a rovnaké cenové kľúče ako úroveň krajiny. Kód naďalej vetvite podľa resolution, nikdy nie podľa tvaru odpovede; odpovede station a country zostávajú nezmenené.

Nový endpoint GET /api/v2/data/fuel-local?lat=&lon= vracia najlepšiu dostupnú cenu paliva pre ľubovoľný bod v Európe. Tam, kde máme údaje o jednotlivých staniciach, odpovie cenami najbližších staníc, inak celoštátnym priemerom krajiny, v ktorej bod leží – vrátane Ukrajiny, kde ceny jednotlivých staníc nie sú nikde.

Každá odpoveď obsahuje pole resolution, ktoré uvádza úroveň, čo odpovedala: station (zoznam staníc s distance_km, každá vo vlastnej mene) alebo country (jeden objekt s celoštátnymi priemermi). Vetvite kód podľa resolution, nikdy nie podľa tvaru odpovede. Dostupné od /api/v2/; fuel, fuel-stations a fuel-cheapest zostávajú nezmenené.

Produkty fuel-stations a fuel-cheapest teraz pokrývajú výrazne viac staníc v Nemecku a ceny sa obnovujú počas celého dňa — vrátane vidieckych oblastí. Parameter fuel_type prijíma 13 druhov paliva: diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 a lng. Ak dopytu nezodpovedá žiadna stanica, odpoveď obsahuje objekt coverage so zoznamom krajín, pre ktoré sú dáta o staniciach k dispozícii.

Parameter radius= sa teraz akceptuje ako kompatibilný alias pre radius_km vo všetkých produktoch, ktoré ho dokumentujú. Produkty fuel-stations a fuel-cheapest vracajú aditívny objekt coverage (zoznam krajín so stanicami plus poznámka) namiesto tichého prázdneho výsledku, keď nevyhovuje žiadna stanica. Objekty hraničných priechodov v route-plan teraz obsahujú aditívny kľúč wait_basis (car_lane verzus vehicle_lane), takže klient vie, kedy sú čakacie doby pre kamióny prevzaté z pruhu pre osobné autá. Priraďovanie kamiónových priechodov pozdĺž trasy je podstatne presnejšie: záloha z osobného pruhu pri dvojiciach priechodov bez dát pre nákladný pruh, poistka proti nesprávnemu smeru, prísnejší limit vzdialenosti a odstránenie duplicít priechodov na rovnakej pozícii. Všetky zmeny sú aditívne, žiadne nekompatibilné zmeny.

Vstupná stránka pre vývojárov má teraz sekcie s kotvami (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) so skokovou navigáciou a každá karta produktu odkazuje na vlastnú stránku dokumentácie. Nová sekcia Mobile apps predstavuje Kordon Online a Truck Bans s odkazmi na Google Play. Doplnenie prekladov: história platieb, chyby prihlásenia, odkazy na sandbox a tlačidlo výberu plánu sú teraz lokalizované vo všetkých 25 jazykoch.

Odpoveď flotilového majáku (POST /api/v1/fleet_position.php) teraz obsahuje pole messages, ktoré doručuje čakajúce správy od vlastníka vodičovi. Nový živý JSON kanál len pre vlastníka (?ajax=live) a karta „Správy pre vodičov“ na paneli flotily. Nová stránka pozvánky pre vodiča /{lang}/get-nakbus (25 jazykov).

Lokalizovaný názov, popis a parametre product_fleet_vehicles/live/history a parametre histórie flotily vo všetkých 25 jazykoch vývojárskeho portálu.

/api/v1/data/truck-bans teraz vracia rovnakú sadu polí najvyššej úrovne bez ohľadu na to, ktorý dopyt vyvolal odpoveď. Predtým mohol dopyt pre krajinu bez kalendárnych zákazov, nerozpoznané ppid alebo bežná zhoda v databáze vynechať rôzne polia (napr. country, covered_countries, ppid). Teraz každá odpoveď dôsledne obsahuje as_of, bans_by_country, countries_not_covered, country, covered_countries, current_bans, is_ban_active, lang, page_url, ppid, relevant_countries, source, success, summary, total_bans a upcoming_bans (null alebo prázdne, ak sa neuplatňuje), čo zjednodušuje spracovanie na strane klienta.

Deväť nových produktov pre jednotlivé služby. Tie, ktoré súvisia s lokalitou, prijímajú lat/lon alebo city + country (mesto za vás geokódujeme sami): /api/v2/data/truck-parkings, /api/v2/data/shops, /api/v2/data/showers, /api/v2/data/restaurants, /api/v2/data/industrial, /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest (stanice zoradené podľa ceny pre daný typ paliva) a /api/v2/data/internet-points; výsledky obsahujú distance_km a sú obmedzené radius. /api/v2/data/vignettes odpovedá, či krajina vyžaduje diaľničnú známku, s aktuálnymi cenami. Existujúci produkt pois teraz podporuje lon a radius podľa dokumentácie a režim mode=nearest produktu fuel tiež prijíma lon. Všetkých deväť je dostupných v sandboxe.

Každý zákaz v /api/v1/data/truck-bans teraz obsahuje restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (presný rozsah alebo dotknuté cesty) a min_weight_tons. details_url teraz smeruje na stránky pre jednotlivé krajiny na nakordoni.eu. Nový voliteľný parameter lang vyberá jazyk názvov krajín a súhrnu; predvolený je teraz angličtina.

Nesprávny ?ppid= teraz vracia skutočný dôvod namiesto strohého "Request failed": chyba pomenuje parameter, očakávaný formát id_<number> a odkáže na /api/v1/data/checkpoints. Tabuľky parametrov pre stats, forecast, update-info, weather a bus-carriers teraz zobrazujú príklad id_13 vo všetkých 25 jazykoch.

Prepracované rozhranie portálu (horná lišta, ikonový bočný panel, KPI prehľad, kartové rozloženie) je teraz predvolené pre všetky prihlásené vývojárske účty — skôr, než bolo plánované spustenie 10. augusta. Na klasické rozloženie sa kedykoľvek vrátite pomocou ?v=1 .

Všetky stránky vývojárskeho portálu — úvod, dokumentácia, prehľad, AI Studio, sandbox, tikety, žiadosti, export, vozový park, novinky, zoznam zmien a stránky účtu — už nenačítavajú žiadne reklamné skripty ani reklamné plochy. Platí to na celom portáli, nielen pri prihlásení a registrácii ako doteraz.

Naplánujte celú cestu cez hranicu jedným volaním: /api/v2/data/route-plan vráti trasu, hraničné priechody, ktoré na nej naozaj ležia, so živým radom alebo predpoveďou na čas vášho príchodu, a zastávky, ktoré vodič skutočne robí — odpočinok, jedlo, tankovanie — na jednej časovej osi.

Hranica je súčasťou tejto osi. Dlhý rad sa počíta ako už splatná prestávka a nuluje čas za volantom, takže trojhodinové čakanie sa nikdy neuvádza ako tri hodiny plus celá sada prestávok, ktoré nikto neurobil. Pre osobné autá platí model bezpečnej jazdy; autobusy a kamióny majú povinný odpočinok podľa EÚ 561/2006 a servisná réžia autobusov je kalibrovaná na viac než 1000 licencovaných medzinárodných cestovných poriadkov. Pridajte stop_places=1, aby každá zastávka dostala skutočné odpočívadlo alebo čerpaciu stanicu, a via=lat,lon, ak chcete viesť trasu cez iný priechod.

Novinka v menu portálu: Prezentácia — živá, vždy aktuálna prezentácia dátovej platformy nakordoni prispôsobená vášmu trhu (poistenie, cestovanie, logistika, dopravcovia, médiá, navigácia, palivo, fintech, verejný sektor alebo osobné projekty). Ukazuje skutočné 30-dňové objemy platformy, vaše vlastné využitie API, štatistiky času odozvy a limitov aj odporúčanie tarify, keď vaše volania narazia na hranice bezplatnej úrovne. Trh (či trhy) si vyberte alebo potvrďte na stránke, vo svojom profile — alebo pri registrácii. Pri prvej návšteve sa otvorí automaticky; automatické otváranie sa dá vypnúť priamo na stránke.

Ak má asistent zapnutý kanál, ale volanie neprináša kontext, ktorý tento kanál potrebuje — napríklad queue bez ppid—, kanál sa teraz preskočí ešte pred akoukoľvek požiadavkou a neúčtuje sa. Predtým sa aj tak zavolal, zlyhal a napriek tomu stál jednotku. Štúdio ukazuje, čo každý kanál potrebuje, pri dopĺňaní kontextu prepočítava cenu a označuje výsledky ✓ prebehol / ⊘ preskočený, bez poplatku / ✕ zlyhal; API vracia data.feeds_skipped , ktoré presne hovorí, ktorý parameter treba odovzdať.

Odpovede už nespomínajú kanály, zdroje dát ani nič technické: chýbajúci kanál je nanajvýš jedna bežná veta pre koncového používateľa, nikdy nie interný názov. Kanály, ktoré majú len voliteľné filtre (napríklad fuel zúžený na krajinu, o ktorej nemáme dáta), sa teraz vrátia k širokému súboru dát namiesto toho, aby nevrátili nič.

Novinka: /{lang}/developers/studio. Postavte si AI asistenta, ktorý odpovedá z vášho obsahu a našich živých hraničných dát. Dajte nám svoj markdown alebo len uveďte stránky a my ich stiahneme a zaindexujeme — vy udržiavate len vlastné súbory. Vyberte, ktoré z našich kanálov môže používať (rad, predpoveď, alternatívy, denné štatistiky, palivo, zákazy pre kamióny, obchodné nedele, sviatky, stav ciest, autobusoví dopravcovia, POI, mena), zvoľte úroveň modelu (rýchly / vyvážený / pro — práve tá určuje cenu), napíšte vlastné inštrukcie so zástupnými symbolmi {{feed.slug}} , ktoré presne určujú, kam v odpovedi patria naše dáta, a pridajte vlastnú záverečnú vetu, ktorá sa pripojí ku každej odpovedi. Hotové vzory: osobný cestovný asistent, pracovný/nákladný asistent, asistent na predaj poistenia a zelenej karty.

Otestujte ho v štúdiu (30 odpovedí denne, oddelene od vašej API kvóty) a potom ho v produkcii volajte cez GET /api/v2/data/assistant-custom?assistant_id=N&q=…. Cena za odpoveď = jednotky úrovne modelu + 1 jednotka za každý zapnutý kanál, vrátená v X-Devapi-Units. Produkt je len vo v2 — URL v1 vráti unsupported_version. Existujúci produkt assistant sa nemení.

Každý asistent beží pod obsahovou politikou platformy, ktorá má prednosť pred vašimi inštrukciami: žiadne vydávanie sa za úradné osoby, žiadna pomoc pri obchádzaní hraničnej či colnej kontroly, žiadne vymyslené čísla, žiadne vulgarizmy. Kontrolujú sa inštrukcie aj odpovede; zablokované volania sa zaznamenávajú.

Novinka: skutočný MCP server na https://nakordoni.eu/mcp, ktorý sprístupňuje bezpečnú podmnožinu API len na čítanie (status, checkpoints, border queue, live queue, forecast) ako MCP nástroje. Rovnaký API kľúč a kvóta ako pri REST API. Karta servera na /.well-known/mcp/server-card.json. Pozrite si časť MCP server v dokumentácii.

Nižšie popísané premenovanie na „Live Queue & Freshness API“ sa v skutočnosti nedostalo na stránku dokumentácie . Stránka vypisuje názov každého produktu cez vyhľadanie prekladu, ktoré siahne po názve koncového bodu len vtedy, keď preklad neexistuje — a preklad už existoval, zamrznutý na starom názve, vo všetkých 25 jazykoch rozhrania. Odteraz má prednosť pred akoukoľvek budúcou zmenou základného názvu, kým sa neaktualizuje aj on.

Kľúč prekladu sme premenovali vo všetkých 25 jazykoch, takže stránka dokumentácie už sedí. Žiadna zmena koncového bodu, parametrov ani odpovede — iba text názvu.

Ak často dopytujete dáta o živom rade, možno zbytočne míňate ťažkú kvótu. /update-info patrí do štandardnej triedy a živú hodnotu už vracia:

GET /api/v1/data/update-info?ppid=id_13

Vracia queue_now, freshness, age_minutes, is_realtime, status, timestamp a timezone. Použite ho na časté obnovovanie z vašej štandardnej dennej kvóty a /queue, /multi a /forecast (všetky ťažkej triedy) si nechajte na prípady, keď potrebujete wait_min, polia trendu alebo históriu.

V samotnom koncovom bode sa nič nezmenilo — iba v jeho dokumentácii. Bol uvedený ako „Data Freshness API“ a jeho popis spomínal len hodnotenie čerstvosti, nikdy queue_now, takže sa dal ľahko prehliadnuť. Teraz sa volá „Live Queue & Freshness API“ a vracané polia sú vypísané. Ďakujeme vývojárovi, ktorý na to upozornil.

Niektoré neúspešné požiadavky vracali HTTP 200 s ok: true a chybou ukrytou vnútri data — zdokumentovaný vzor if (!ok) throw ich teda nedokázal odhaliť a volanie sa aj tak účtovalo. Dotknuté volania teraz vracajú HTTP 400 s ok: false a poriadnymi error.code / error.messagepodľa dokumentácie. Zaznamenané pri fuel-cities s nepodporovanou krajinou a pri travel-matrix s chybnými súradnicami.

Osobitne: chýbajúci povinný parameter vracal 500 internal_error namiesto 400 bad_request (telo odpovede 4xx z interného servisu sa zahodilo skôr, než sa prečítal jeho status). Teraz sa vracia 400 bad_request so správou interného servisu — napr. search bez ?name=.

Úspešné odpovede sú nezmenené do posledného bajtu — rovnaké polia, rovnaké parametre, rovnaká cena kvóty. Ak sa váš klient už vetví podľa ok, nemusíte meniť nič. Ak ok ignoroval a čítal priamo data , uvidí teraz chybové obálky pri volaniach, ktoré aj tak vždy zlyhávali.

Opravili sme chybu, pri ktorej /multi mohol vrátiť nesprávny počet áut v rade pre niektoré priechody — najmä balkánske a na hranici Maďarsko–Srbsko — vždy, keď bola jeho vyrovnávacia pamäť studená. Záložná cesta čítala tabuľku, ktorá pre tieto priechody neobsahuje dáta o rade, a nesúvisiace hodnoty hlásila ako počty áut. Namerané príklady: priechod s 12 autami hlásil 6 a niekoľko so skutočnými radmi hlásilo 0.

Tri zmeny, ktoré si môžete všimnúť:

• found: false teraz znamená, že naozaj nie sú žiadne čerstvé dáta o rade. Predtým ste mohli dostať found: true s vymysleným queue_now: 0.
• wait_status, trend_percent a trend_direction sa teraz vracajú aj pri studených požiadavkách — predtým boli null .
• Koncový bod prejde na záložnú cestu aj vtedy, keď je jeho uložená snímka zastaraná (staršia ako 24 h), nielen keď chýba.

Žiadne zmeny parametrov požiadavky, ceny kvóty ani štruktúry odpovede.

Opravili sme chybu, kvôli ktorej sa každé volanie /multi účtovalo dvakrát — raz všeobecnou kontrolou 1 jednotky a znova vlastným vzorcom premenlivých nákladov endpointu (N PPID × podprodukty). Volanie teraz stojí presne ⌈(N×M)/2⌉ jednotiek podľa dokumentácie, bez ďalšieho poplatku.

Na stránke dokumentácie sme tiež pridali odznak triedy kvóty (Standard/Heavy) pri každom produkte, aby bolo na prvý pohľad jasné, z ktorej dennej kvóty daný endpoint čerpá.

Parametre country a countries boli zlucene do jedneho parametra (1-15 kodov oddelenych ciarkami). Novy parameter compare_to: porovnanie rovnakych vs. odlisnych sviatkov medzi krajinami, kombinuje sa s upcoming+days. lang teraz prijima viacero jazykov (pridava objekt names). days=0 alebo vynechane teraz znamena bez obmedzenia v rezime upcoming.

Oficialne statne sviatky pre jednotlive europske krajiny — datumy, miestne nazvy a typ. Postavene na tej istej sluzbe Nager.Date / OpenHolidaysAPI (s lokalne vypocitanym kalendarom pre Kosovo), ktora pohana stranku kalendara sviatkov na nakordoni.eu a kalendarove faktory predikcneho systemu.

• ?country=PL&year=2026 — celorocny zoznam sviatkov pre jednu krajinu
• ?upcoming=1&days=30 — plochy zoznam nadchadzajucich sviatkov napriec krajinami
• Bez parametrov — index zakladnej mnoziny krajin s najblizsim sviatkom pre kazdu z nich

Pridany produkt currency — vymenne kurzy voci EUR pre PLN, CZK, HUF, USD, GBP, CHF, NOK a UAH, ziskane zo sluzby Frankfurter (ECB) a cachovane 6 hodin. Bez parametrov, vzdy vracia uplnu tabulku kurzov. Pozri dokumentaciu.

Vlozte zive europske zakazy jazdy kamionov na svoju vlastnu webovu stranku — bezplatny iframe widget s 3 dizajnmi (light, dark, board), 5 jazykmi (en, uk, pl, de, ru), volitelnym filtrom podla krajiny a zivym stavom «aktivne teraz». Nie je potrebny ziadny API kluc. Nastavte a skopirujte kod na nakordoni.eu/en/for_truck_drivers/traffic_bans/widget. Uprednostnujete surove data? Produkt API truck-bans a verejny JSON feed zostavaju k dispozicii.

Tri novinky, vsetky spatne kompatibilne — v1 sa nemeni.

Verzovanie na urovni endpointu. Teraz existuje zakladna URL /api/v2/. Je to na urovni jednotlivych endpointov: iba endpointy, ktore sa naozaj zmenili, sa pod v2 spravaju inak; kazdy ostatny endpoint transparentne vracia svoju v1 odpoved (takze /api/v2/data/queue = rovnake data ako v1, len s "api_version":"v2"). Endpointy, ktore funguju, netreba migrovat.

border v2 je smerovy. Poradie v ceste urcuje smer cesty:

GET /api/v2/data/border/1/2/6   → buses UA→PL (Ukrainian-side crossings)
GET /api/v2/data/border/2/1/6   → buses PL→UA (Polish-side crossings)

Kazdy checkpoint tiez ziskava objekt direction {from,to} a boolean stale a ?max_age_min=N vracia iba nedavno aktualizovane priechody. (v1 border nadalej vracia obe strany hranice bez ohladu na poradie — nezmenene.)

Interaktivny Sandbox. Prihlaseni vyvojari mozu teraz vyskusat ktorykolvek endpoint priamo z prehliadaca na Developers → Sandbox — vyberte endpoint, verziu a jeden zo svojich klucov, upravte parametre a pozrite si zivu odpoved. Testovanie v Sandboxe ma vlastny samostatny denny rozpocet (50 volani/den) a nikdy sa nedotyka vasej zivej API kvoty.

Dokumentacia je teraz rozdelena podla endpointov (Developers → API Docs) s vyberom verzie pri endpointoch, ktore maju viac ako jednu verziu.

Do vzorca casu cakania boli pridane dva nove faktory, popri existujucich upravach section_mode a pocasia:

• service_rate — namerany pocet aut/min, ktore sa prave spracuvaju, oproti nakonfigurovanej zakladnej rychlosti priechodu. Multiplikativny, ohraniceny na 0.5x-1.5x.
• shift_change — vplyv miestnej vymeny sluzby pohranicnikov o 08:00/20:00 na danom priechode. Aditivny (v minutach), nie multiplikativny — aplikuje sa iba v rozmedzi +/-60 minut od vymeny, vyzaduje minimalnu historiu vzoriek, ohraniceny na +/-120 minut.

advanced_wait_min je teraz round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min. Oba faktory sa premietaju aj do driver_reported.prognosed_advanced_wait_min pre historicke porovnania.

V ramci bezpecnostnej/sukromnej revizie boli odstranene nasledujuce polia — odhalovali interne implementacne detaily (nasu taxonomiu zdrojovych dat, ID riadkov v databaze, interne anotacie pipeline, nepouzivane/mrtve polia) bez realnej hodnoty pre produkt:

• id a corrected — odstranene z riadkovych objektov queue
• source (surovy retazec, napr. "line") — odstranene z queue, multi a update-info. update-info a multi vo svojom bloku update_info nadalej obsahuju source_category/source_label_en (maly verejny slovnik); queue a multi vo svojom bloku queue uz neobsahuju ziadne pole source
• traffic_status — odstranene z border; bolo vzdy null a ziadna cast systemu ho nikdy nenaplnala

Ak vasa integracia cita niektore z tychto poli, aktualizujte ju — pozri aktualny zoznam poli na stranke dokumentacie prislusneho produktu.

Denne vyuzitie kvoty (usage.used v kazdej odpovedi) teraz moze byt desatinna hodnota (napr. 67.5) namiesto vzdy celeho cisla. Je to vedlajsi efekt toho, ze queue-advanced sa uctuje zlomkovou sadzbou — pozri nizsie. usage.limit zostava nezmenene a je vzdy cele cislo. Ak vas klient striktne typuje usage.used ako cele cislo, rozsirte ho, aby prijimalo desatinne cislo/float.

Tieto tri produkty teraz vracaju tie iste polia ziveho stavu, ake zobrazuje web: wait_status (green/yellow/red, na zaklade vlastnej nedavnej historie daneho priechodu) a trend_percent/trend_direction (up/up-slight/down/down-slight/stable, s porovnanim poslednych 3 hodin). Cisto aditivne.

V /api/v1/data/queue mali riadky data[] predtym pre vacsinu zdrojov wait_time: null — iba niekolko zdrojovych feedov hlasi cas cakania priamo. Riadky bez neho teraz dostavaju standardny odhad , oznaceny novym booleanom wait_time_estimated, aby ste rozlisili skutocne nahlasene cislo od vypocitaneho.

queue-advanced teraz stoji 1.5 jednotky za volanie namiesto 1 (odraza dodatocne vyhladavania premavky/pocasia/hlaseni vodicov, ktore vykonava) — pozri usage.used vyssie. Odpoved uz tiez neobsahuje total_crossing_time a driver_reported je teraz iba {wait_min, ts, age_min} — predchadzajuce polia porovnania prognozy so skutocnostou (prognosed_wait_min, diff_min, historical_section_mode, historical_weather atd.) boli odstranene. section_mode, weather, advanced_wait_min a exceeds_crossing_time zostavaju nezmenene.

/api/v1/data/truck-bans teraz pre kazdu krajinu v bans_by_country vracia status (active/clear) plus active_window, next_window, local_time a tz — vypocitane v casovom pasme danej krajiny, takze uz nemusite sami vyhodnocovat surove okna zakazov voci hodinam. Odpoved tiez pridava zoznam covered_countries na najvyssej urovni a UTC casovu peciatku as_of.

GET /api/v1/data/truck-bans?country=PL

Cisto aditivne — existujuce polia current_bans/upcoming_bans/bans_by_country zostavaju nezmenene. Nezname ?country= teraz vracia prazdny vysledok s countries_not_covered namiesto zakazov vsetkych krajin.

Novy volitelny produkt, ktory upravuje standardny cas cakania podla ziveho toku premavky a pocasia. Vracia uplny rozpis kazdej upravy.

GET /api/v1/data/queue-advanced?ppid=id_13

Udeluje sa na poziadanie — otvorte Data ticket zo svojho dashboardu, aby ste ho aktivovali.

/api/v1/data/border teraz spravne vypocita wait_min pre kazdy checkpoint v odpovedi, v sulade s produktmi queue a multi. Predtym bolo toto pole vzdy null.

/api/v1/data/forecast teraz spolahlivo pouziva ensemble model v4 pre akukolvek hodnotu prediction_steps (predtym sa niektore nestandardne horizonty mohli potichu vratit k starsiemu modelu). Faktor pocasia, ktory napaja ensemble, je tiez opraveny a teraz skutocne odraza zive podmienky (dazd, sneh, vietor, hmla) namiesto toho, aby vzdy hlasil nedostupnost.

Schvaleni vyvojari mozu teraz stiahnut hodinovo spriemerovane historicke data o hranicnych radoch az pre 5 checkpointov (klzave okno az 90 dni) ako CSV alebo NDJSON z novej zalozky Data export. Data su iba publikovane a kontrolovane na kvalitu; casove peciatky su v UTC. Potrebujete pristup? Otvorte Data ticket.

Este nemate web? Teraz si mozete vytvorit vyvojarske konto tak, ze opisete, kde a ako planujete pouzivat nase data, namiesto povinneho zadania URL zivej stranky. Skutocnu URL pridajte neskor zo svojho dashboardu (Ucet & data → Vas projekt), hned ako bude vasa stranka alebo aplikacia spustena — viditelny spatny odkaz na nakordoni.eu na tejto stranke vyzaduju nase Podmienky.

Vyvojari mozu teraz odosielat vlastne spravy suvisiace s hranicami do spravodajskej linky Nakordoni. Ak ich nasi redaktori publikuju, ziskate indexovatelny dofollow spatny odkaz na vasu sluzbu (uvedenie vydavatela + riadok zdroja) a clanok bezplatne prelozime do vsetkych 24 jazykov.

Jeden clanok tyzdenne je zadarmo; dalsie clanky su plateny doplnok. Vyberte si 'mozeme mierne upravit + pridat interne odkazy' alebo 'publikovat bez uprav'. Odosielajte a sledujte stav kontroly v Developers → Submit news.

Multi-Checkpoint API (/api/v1/data/multi) teraz uctuje kvotu ako ⌈(N PPIDs × podprodukty) / 2⌉ — polovica ceny ekvivalentnych samostatnych volani. Poziadavka na 10 checkpointov s oboma podproduktmi teraz stoji 10 jednotiek namiesto 20. Hlavicka X-Devapi-Units a meta.units_consumed v odpovedi odrazaju zlavnenu sumu.

Ziskajte zivy stav radu a cerstvost dat az pre 20 checkpointov v jednom API volani — urcene pre tvorcov dashboardov, ktori teraz v cykle dopytuju mnoho PPIDs.

Kvota sa pocita ferovo ako N PPIDs × podprodukty vyziadane, takze celkove vyuzitie je totozne so samostatnymi volaniami — ale s jednym round-tripom namiesto mnohych. Vzory typu GreenTravel klesnu z 24+ volani/hod na 2.

GET /api/v1/data/multi?ppids=id_2,id_13,id_15,id_59&include=queue,update-info&lang=en

• include=queue — aktualne queue_now, odhadovane wait_min, vek dat a nazov checkpointu
• include=update-info — cerstvost dat, klasifikacia zdroja, vek v sekundach/minutach
• Max 20 PPIDs na poziadavku; kombinujte oba podprodukty v jednom volani pre kompletne data dashboardu
• Odpoved obsahuje meta.units_consumed, takze mozete presne sledovat vyuzitie kvoty

Odpoved produktu queue teraz obsahuje objekt snapshot na najvyssej urovni s najnovsimi datami v realnom case a vypocitanym prognozovanym casom cakania — rovnaky vzorec, aky sa pouziva v hero sekcii na nakordoni.eu:

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — prognosed wait time (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

Pole data (historicke zaznamy) zostava nezmenene — ide o cisto aditivne rozsirenie. Klientov, ktori necitaju snapshot, sa to netyka.

Dopytujte vsetky checkpointy na danej hranici + typ vozidla jednym volanim namiesto jednej poziadavky na PPID.

GET /api/v1/data/border/{origin}/{destination}/{crossing_type}

• Podporuje jednu cielovu krajinu, zoznam oddeleny ciarkami alebo all na rozsirenie na vsetkych monitorovanych susedov naraz.
• Vysledky zoradene podla queue_now vzostupne (najkratsi rad ako prvy).
• Plne lokalizovane: pridajte ?lang=uk (alebo ktorykolvek z nasich 22 podporovanych jazykov) na ziskanie nazvov checkpointov v danom jazyku.

Objavte hodnoty PPID checkpointov podla nazvu bez prehliadania celeho adresara.

GET /api/v1/data/search?name=Krakovets,Shehyni&lang=en

• Prijima jeden nazov alebo zoznam oddeleny ciarkami (az 20).
• Vyhladava vo vsetkych 24 prekladovych jazykoch — zadajte nazov v ukrajincine, polstine, nemcine alebo ktoromkolvek podporovanom jazyku a najde zhodu.
• Vracia vsetky PPIDs na danom mieste zoskupene podla typu vozidla (auto / autobus / chodec / kamion).

Produkt alternatives teraz prijima ?lang= vo vsetkych 22 podporovanych jazykoch (predtym iba 12).

Novy parameter crossing_type vam umoznuje prepisat filter typu vozidla — napr. zadajte crossing_type=4 na ziskanie alternativ pre auta, aj ked sa dopytujete z autobusoveho PPID.

Pole crossing_type_label v odpovediach checkpoints, border a search je teraz prelozene do pozadovaneho jazyka vo vsetkych 22 podporovanych jazykoch. Polia s nazvami krajin (origin_name, destination_name) sa riadia rovnakym locale.

Portal Nakordoni Developer API je spusteny na /en/developers. Zaregistrujte sa pre bezplatny Explorer kluc (200 poziadaviek/den) a ziskajte pristup k datam o hranicnych radoch, predpovediam, cenam paliv, vodicskym POIs a dalsiemu.

Produkty dostupne pri spusteni: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.