Историја измена API

Ново: прави MCP сервер на https://nakordoni.eu/mcp, који излаже безбедан подскуп API-ја само за читање (status, checkpoints, border queue, live queue, forecast) као MCP алате. Исти API кључ и квота као код REST API-ја. Картица сервера на /.well-known/mcp/server-card.json. Погледајте одељак MCP сервер у документацији.

The retitle to "Live Queue & Freshness API" below did not actually reach the docs page. The page renders each product title through a translation lookup that falls back to the endpoint's title only when no translation exists — and a translation already existed, frozen at the old name, in all 25 UI languages. It now wins over any future update to the underlying title until it is updated too.

Retitled the translation key in all 25 languages so the docs page matches. No endpoint, parameter or response change — title text only.

If you poll live queue data frequently, you may be spending heavy quota you do not need to. /update-info is standard-class and already returns the live figure:

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

It returns queue_now, freshness, age_minutes, is_realtime, status, timestamp and timezone. Use it for the frequent refresh against your standard daily quota, and keep /queue, /multi and /forecast (all heavy-class) for when you need wait_min, the trend fields or history.

Nothing changed in the endpoint itself — only its documentation. It was listed as the "Data Freshness API" and its description mentioned only the freshness rating, never queue_now, so it was easy to miss. It is now titled "Live Queue & Freshness API" with the returned fields spelled out. Thanks to the developer who raised this.

Some failed requests were returning HTTP 200 with ok: true and the error buried inside data — so the documented if (!ok) throw pattern could not detect them, and the call was still billed. Affected calls now return HTTP 400 with ok: false and a proper error.code / error.message, as documented. Seen on fuel-cities with an unsupported country and travel-matrix with malformed coordinates.

Separately, a missing required parameter returned 500 internal_error instead of 400 bad_request (an upstream 4xx body was being discarded before its status was read). It now returns 400 bad_request with the upstream message — e.g. search without ?name=.

Successful responses are byte-for-byte unchanged — same fields, same params, same quota cost. If your client already branches on ok, no change is needed. If it ignored ok and read data directly, it will now see error envelopes on calls that were always failing.

Fixed a bug where /multi could return a wrong queue count for some checkpoints — mainly Balkan and Hungary–Serbia crossings — whenever its cache was cold. The fallback read a table that, for those crossings, holds no queue data, and reported unrelated values as car counts. Measured examples: a checkpoint with 12 cars reported 6, and several with real queues reported 0.

Three changes you may notice:

• found: false now means there is genuinely no recent queue data. Previously you could receive found: true with a fabricated queue_now: 0.
• wait_status, trend_percent and trend_direction are now returned on cold requests — they were null before.
• The endpoint also falls back when its cached snapshot is stale (older than 24h), not only when it is missing.

No changes to request parameters, quota cost or response shape.

Ispravljena je greška zbog koje se svaki poziv /multi naplaćivao dvaput — jednom generičkom proverom od 1 jedinice, a zatim ponovo sopstvenom formulom promenljivog troška endpointa (N PPID × podproizvodi). Poziv sada košta tačno ⌈(N×M)/2⌉ jedinica kao što je dokumentovano, bez dodatne naplate.

Takođe je dodata oznaka klase kvote (Standard/Heavy) za svaki proizvod na stranici dokumentacije, kako bi na prvi pogled bilo jasno koju dnevnu kvotu koristi endpoint.

Parametri country i countries spojeni su u jedan parametar (1-15 kodova razdvojenih zarezima). Novi parametar compare_to: poredjenje istih naspram razlicitih praznika medju zemljama, kombinuje se sa upcoming+days. lang sada prihvata vise jezika (dodaje objekat names). days=0 ili izostavljeno sada znaci bez ogranicenja u rezimu upcoming.

Zvanicni drzavni praznici po evropskoj zemlji — datumi, lokalni nazivi i tip. Oslanja se na istu uslugu Nager.Date / OpenHolidaysAPI (sa lokalno izracunatim kalendarom za Kosovo) koja pokrece stranicu kalendara praznika na nakordoni.eu i kalendarske faktore sistema za predvidjanje.

• ?country=PL&year=2026 — celogodisnji spisak praznika za jednu zemlju
• ?upcoming=1&days=30 — ravan spisak predstojecih praznika kroz zemlje
• Bez parametara — indeks osnovnog skupa zemalja sa sledecim praznikom za svaku

Dodat je proizvod currency — kursevi u odnosu na EUR za PLN, CZK, HUF, USD, GBP, CHF, NOK i UAH, preuzeti sa Frankfurter (ECB) i kesirani 6 sati. Bez parametara, uvek vraca celu tabelu kurseva. Vidi dokumentaciju.

Ugradite na sopstveni sajt aktuelne evropske zabrane voznje kamiona — besplatan iframe widget sa 3 dizajna (light, dark, board), 5 jezika (en, uk, pl, de, ru), opcionim filterom po zemlji i statusom uzivo «aktivno sada». Nije potreban API kljuc. Podesite i kopirajte kod na nakordoni.eu/en/for_truck_drivers/traffic_bans/widget. Vise volite sirove podatke? API proizvod truck-bans i javni JSON feed ostaju dostupni.

Tri dodatka, svi unazad kompatibilni — v1 je nepromenjen.

Verzionisanje po endpointu. Sada postoji bazni URL /api/v2/. To je po pojedinacnom endpointu: samo endpointi koji su se zaista promenili ponasaju se drugacije pod v2; svaki drugi endpoint transparentno vraca svoj v1 odgovor (tako da /api/v2/data/queue = isti podaci kao v1, samo sa "api_version":"v2"). Nema potrebe da migrirate endpointe koji rade.

border v2 je usmeren. Redosled u putanji odredjuje smer putovanja:

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)

Svaki checkpoint takodje dobija objekat direction {from,to} i boolean stale, a ?max_age_min=N vraca samo nedavno azurirane prelaze. (v1 border i dalje vraca obe strane granice bez obzira na redosled — nepromenjen.)

Interaktivni Sandbox. Prijavljeni programeri sada mogu da isprobaju bilo koji endpoint direktno iz pregledaca na Developers → Sandbox — izaberite endpoint, verziju i jedan od svojih kljuceva, podesite parametre i vidite odgovor uzivo. Testiranje u Sandbox-u ima sopstveni zaseban dnevni budzet (50 poziva/dan) i nikada ne dira vasu stvarnu API kvotu.

Dokumentacija je sada podeljena po endpointu (Developers → API Docs) sa biracem verzije kod endpointa koji imaju vise od jedne verzije.

U formulu vremena cekanja dodata su dva nova faktora, uz postojeca prilagodjavanja section_mode i vremenskih uslova:

• service_rate — izmereni automobili/min koji se trenutno obradjuju u odnosu na konfigurisanu osnovnu brzinu prelaza. Multiplikativan, ogranicen na 0.5x-1.5x.
• shift_change — uticaj lokalne smene granicara u 08:00/20:00 na samom prelazu. Aditivan (minuti), ne multiplikativan — primenjuje se samo u okviru +/-60 minuta od smene, zahteva minimalnu istoriju uzoraka, ogranicen na +/-120 minuta.

advanced_wait_min je sada round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min. Oba faktora se odrazavaju i u driver_reported.prognosed_advanced_wait_min za istorijska poredjenja.

U okviru bezbednosne/privatne revizije, sledeca polja su uklonjena — otkrivala su interne detalje implementacije (nasu taksonomiju izvora podataka, ID redova u bazi, interne anotacije pipeline-a, neiskoriscena/mrtva polja) bez stvarne vrednosti za proizvod:

• id i corrected — uklonjeni iz redova objekata queue
• tmin/tpercar — uklonjeni iz queue, border i multi (konstante formule vremena cekanja; vec izracunato wait_min/wait_time nije pogodjeno)
• source (sirov string, npr. "line") — uklonjeno iz queue, multi i update-info. update-info i multi u svom bloku update_info i dalje sadrze source_category/source_label_en (mali javni recnik); queue i multi u svom bloku queue vise uopste ne sadrze polje source
• traffic_status — uklonjeno iz border; uvek je bilo null i nijedan deo sistema ga nikada nije popunjavao

Ako vasa integracija cita neko od ovih polja, molimo azurirajte je — pogledajte aktuelnu listu polja na stranici dokumentacije odgovarajuceg proizvoda.

Dnevna potrosnja kvote (usage.used u svakom odgovoru) sada moze biti decimalna vrednost (npr. 67.5) umesto uvek ceo broj. Ovo je sporedni efekat toga sto se queue-advanced naplacuje po razlomljenoj stopi — vidite ispod. usage.limit nije pogodjeno i uvek je ceo broj. Ako vas klijent striktno tipizira usage.used kao ceo broj, molimo prosirite ga da prihvata decimalni broj/float.

Ova tri proizvoda sada vracaju ista polja statusa uzivo koja prikazuje sajt: wait_status (green/yellow/red, na osnovu sopstvene nedavne istorije ovog prelaza) i trend_percent/trend_direction (up/up-slight/down/down-slight/stable, poredeci poslednja 3 sata). Cisto aditivno.

U /api/v1/data/queue redovi data[] ranije su imali wait_time: null za vecinu izvora — samo nekoliko izvornih fidova prijavljuje vreme cekanja direktno. Redovi bez njega sada dobijaju standardnu procenu tmin + queue×tpercar, oznacenu novim boolean-om wait_time_estimated, kako biste razlikovali stvarno prijavljenu vrednost od izracunate.

queue-advanced sada kosta 1.5 jedinica po pozivu umesto 1 (odrazava dodatne provere saobracaja/vremena/izvestaja vozaca koje obavlja) — vidite usage.used iznad. Odgovor takodje vise ne ukljucuje tmin, tpercar ili total_crossing_time, a driver_reported je sada samo {wait_min, ts, age_min} — prethodna polja za poredjenje prognoze sa stvarnoscu (prognosed_wait_min, diff_min, historical_section_mode, historical_weather itd.) su uklonjena. section_mode, weather, advanced_wait_min i exceeds_crossing_time ostaju nepromenjeni.

/api/v1/data/truck-bans sada za svaku zemlju u bans_by_country vraca status (active/clear) plus active_window, next_window, local_time i tz — izracunate u sopstvenoj vremenskoj zoni te zemlje, tako da vise ne morate sami da procenjujete sirove prozore zabrana u odnosu na sat. Odgovor takodje dodaje listu covered_countries na najvisem nivou i UTC vremensku oznaku as_of.

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

Cisto aditivno — postojeca polja current_bans/upcoming_bans/bans_by_country su nepromenjena. Nepoznato ?country= sada vraca prazan rezultat sa countries_not_covered umesto zabrana svake zemlje.

Novi opcioni proizvod koji prilagodjava standardno vreme cekanja prema aktuelnom protoku saobracaja i vremenu. Vraca potpunu razradu svakog prilagodjavanja.

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

Dodeljuje se na zahtev — otvorite Data ticket sa svoje kontrolne table da biste ga aktivirali.

/api/v1/data/border sada ispravno izracunava wait_min (i vraca tmin/tpercar) za svaki checkpoint u odgovoru, u skladu sa proizvodima queue i multi. Ranije je ovo polje uvek bilo null.

/api/v1/data/forecast sada pouzdano koristi ansambl model v4 za bilo koju vrednost prediction_steps (ranije su neki nestandardni horizonti mogli tiho da se vrate na stariji model). Faktor vremena koji napaja ansambl je takodje popravljen i sada zaista odrazava aktuelne uslove (kisa, sneg, vetar, magla) umesto da uvek prijavljuje nedostupnost.

Odobreni programeri sada mogu da preuzmu satno usrednjene istorijske podatke o granicnim redovima za najvise 5 checkpoint-a (klizni prozor do 90 dana) kao CSV ili NDJSON iz nove kartice Data export. Podaci su samo objavljeni i provereni na kvalitet; vremenske oznake su u UTC. Potreban vam je pristup? Otvorite Data ticket.

Jos nemate sajt? Sada mozete da napravite programerski nalog tako sto cete opisati gde i kako planirate da koristite nase podatke, umesto da morate da unesete URL aktivne stranice. Dodajte stvarni URL kasnije sa svoje kontrolne table (Nalog & podaci → Vas projekat), cim vas sajt ili aplikacija budu aktivni — vidljiva povratna veza ka nakordoni.eu na toj stranici zahteva se nasim Uslovima.

Programeri sada mogu da salju sopstvene vesti vezane za granice u vesti liniju Nakordoni. Ako ih nasi urednici objave, dobijate indeksibilan dofollow povratni link ka vasoj usluzi (naveden izdavac + red izvora) i prevodimo clanak na svih 24 jezika besplatno.

Jedan clanak nedeljno je besplatan; dodatni clanci su placeni dodatak. Izaberite 'mozemo lako da uredimo + dodamo interne linkove' ili 'objavi bez izmena'. Saljite i pratite status pregleda u Developers → Submit news.

Multi-Checkpoint API (/api/v1/data/multi) sada naplacuje kvotu kao ⌈(N PPIDs × pod-proizvodi) / 2⌉ — polovina cene ekvivalentnih pojedinacnih poziva. Zahtev za 10 checkpoint-a sa oba pod-proizvoda sada kosta 10 jedinica umesto 20. Zaglavlje X-Devapi-Units i meta.units_consumed u odgovoru odrazavaju umanjeni iznos.

Preuzmite status reda uzivo i svezinu podataka za najvise 20 checkpoint-a jednim API pozivom — namenjeno kreatorima kontrolnih tabli koji trenutno u petlji ispituju mnogo PPIDs.

Kvota se broji posteno kao N PPIDs × pod-proizvodi zatrazeni, tako da je ukupna potrosnja identicna pojedinacnim pozivima — ali sa jednim odlaskom-povratkom umesto mnogo. Obrasci tipa GreenTravel padaju sa 24+ poziva/sat na 2.

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

• include=queue — trenutno queue_now, procenjeno wait_min, starost podataka i ime checkpoint-a
• include=update-info — svezina podataka, klasifikacija izvora, starost u sekundama/minutima
• Maks 20 PPIDs po zahtevu; kombinujte oba pod-proizvoda u jednom pozivu za kompletne podatke kontrolne table
• Odgovor ukljucuje meta.units_consumed kako biste precizno pratili potrosnju kvote

Odgovor proizvoda queue sada ukljucuje objekat snapshot na najvisem nivou sa najnovijim podacima u realnom vremenu i izracunatim prognoziranim vremenom cekanja — ista formula koja se koristi u hero sekciji na nakordoni.eu:

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — tmin + queue_now × tpercar (minutes)
snapshot.tmin       — minimum crossing time (minutes)
snapshot.tpercar    — added time per vehicle (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

Niz data (istorijski unosi) je nepromenjen — ovo je cisto aditivan dodatak. Klijenti koji ne citaju snapshot nisu pogodjeni.

Upitajte sve checkpoint-e na datoj granici + tip vozila jednim pozivom umesto jednog zahteva po PPID.

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

• Podrzava jednu ciljnu zemlju, listu razdvojenu zarezima, ili all za prosirenje na sve pracene susede odjednom.
• Rezultati sortirani po queue_now rastuce (najkraci red prvi).
• Potpuno lokalizovano: dodajte ?lang=uk (ili bilo koji od nasih 22 podrzana jezika) da dobijete imena checkpoint-a na tom jeziku.

Otkrivajte vrednosti PPID checkpoint-a po imenu bez pregledanja celog direktorijuma.

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

• Prihvata jedno ime ili listu razdvojenu zarezima (do 20).
• Pretrazuje kroz svih 24 prevodilacka jezika — unesite ime na ukrajinskom, poljskom, nemackom ili bilo kom podrzanom jeziku i pronaci ce poklapanje.
• Vraca sve PPIDs na toj lokaciji grupisane po tipu vozila (automobil / autobus / pesak / kamion).

Proizvod alternatives sada prihvata ?lang= na svih 22 podrzana jezika (ranije samo 12).

Novi parametar crossing_type omogucava vam da zamenite filter tipa vozila — npr. prosledite crossing_type=4 da dobijete alternative za automobile cak i kada upitujete iz autobuskog PPID.

Polje crossing_type_label u odgovorima checkpoints, border i search sada je prevedeno na trazeni jezik na svih 22 podrzana jezika. Polja sa imenima zemalja (origin_name, destination_name) prate isti locale.

Portal Nakordoni Developer API je dostupan na /en/developers. Registrujte se za besplatan Explorer kljuc (200 zahteva/dan) da biste pristupili podacima o granicnim redovima, prognozama, cenama goriva, vozackim POIs i jos.

Proizvodi dostupni pri pokretanju: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.