Zoznam zmien API

On Fuel Prices, updated_at and the response's own age_hours/stale flag were running on different clocks: updated_at moves only when a price actually changes, but staleness was computed as if it moved on every confirmation. 46.7% of the priced index showed age_hours ≤48 and stale:false while updated_at was in fact more than 48 hours old, 12,620 stations over a week old. Each price now also carries confirmed_at — the last time we confirmed the price, hour-floored, never earlier than updated_at — and age_hours/stale are computed from it. updated_at's meaning is unchanged: use it when you want to know when the price last moved, use confirmed_at when you want to know how current it is right now. Not present on the frozen v1 contract.

Two language bugs, both silent: sending the canonical grade code as lang=pl (or any of the other 24 site languages) got fuel_type_local back in English regardless — only 10 languages were ever checked against the label table, so anything outside that list fell through to the default UI vocabulary rather than the language you asked for. Separately, lang=tr (or several other valid codes) answered station listings in Ukrainian, because an internal default of uk fired whenever the requested language did not sit in that same 10-language list. Both are fixed: the language you send is now the language you get, across all 25.

Also: brand on Nearby Fuel Stations no longer returns the raw ingest sentinel OTHER for the ~330 stations where we do not know the brand — it is null, consistent with every other unknown field in the response.

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   — (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.