Историја измена 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.

Border AI Assistant (/api/v1/data/assistant) враћао је 503 internal_error — „Assistant temporarily unavailable“ — када би исти кључ поставио исто питање два пута у року од пет минута. Ништа заправо није било недоступно: у већини тих случајева одговор је већ био израчунат и спреман да буде враћен. Сада се враћа нормално, са ok: true и HTTP 200.

Када понављање стигне док се први одговор још уписује, позив сада враћа 429 са error.code вредности duplicate_request уместо 503, тако да политика поновних покушаја може да разликује „питајте поново за тренутак“ од стварног испада. Оба случаја су се такође рачунала у стопу грешака вашег налога као серверске грешке; више се не рачунају. У самом захтеву се ништа не мења — ниједан параметар, ниједна верзија. duplicate_request наведен је уз остале кодове грешака у референтној документацији.

Truck Parking (/api/v2/data/truck-parkings) враћао је уносе са name вредности null и празним address — код Бенсхајма, 20 од 50. То су места која чувамо само као координату, без ичега за приказ и без ичега за упаривање са вашим сопственим скупом POI. Она више нису део овог производа: сада се враћају само локације са именом, тренутно више од 22.000 широм Европе. Ако сте сами филтрирали уносе без имена, тај код је сада сувишан, али безопасан. Одговори постају краћи за исти radius и limit, а сваки унос који стигне употребљив је.

Одвојено, око 10.000 паркинга носило је сиров пар координата као name, на пример 51.927301,10.14112, док је стварна ознака стајала у address. Сада носе ту ознаку — Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — свуда где се појављују, укључујући /api/v1/data/pois. id сваког места остаје непромењен, па кеширано мапирање остаје важеће; мења се само name.

snapshot.updated_at на /api/v1/data/queue и /api/v1/data/multi јесте локално време у сопственој зони граничног прелаза (на пример Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv), а до сада ништа у одговору није говорило која је то зона, па позивалац није могао да га сведе на тачан тренутак. snapshot добија додатно поље timezone (IANA назив) уз updated_at. Без новог параметра, без нове верзије, без промене осталих поља.

До сада је свака крајња тачка за гориво описивала сопствену покривеност ручно писаном листом: AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, при чему је Пољска у њој била сведена на подручје Тројмјаста. Обе тврдње су одавно застареле. Покривеност се сада мери из живог индекса станица и поново израчунава сваких шест сати: 39 земаља данас има станице са ценама, а међу њима и Пољска на целој територији, а не у три града. У самом захтеву се не мења ништа: ни параметар ни верзија.

Nearby Fuel Stations и Cheapest Fuel: када претрага не врати ништа, блок coverage сада носи измерене station_countries, station_counts, sparse_coverage и measured_at, сужене на тражену врсту горива, а не на гориво уопште. Земља доспева у sparse_coverage када у њој имамо 25 станица са ценом или мање — то је бројање, а не процена.

Појавила се нова напомена за врсту коју препознајемо, али коју нико не котира тамо где сте питали. До сада се coverage.fuel_type_note појављивала само када нам је само име са точионика било непознато. Сада се појављује и када се име исправно препозна, а у тој земљи за њега једноставно нема цене; наводи земље у којима се та врста котира и врсте које котирамо око вас. Чешко име Natural 100 је чист пример: препознаје се, али у Чешкој му ниједан извор не даје цену. Празан одговор више не изгледа као покварен захтев.

Fuel Grades (/api/v2/data/fuel-grades) добија priced_countries и priced_station_counts за сваку врсту, уз priced_here када пошаљете ?country=. Те две листе значе различите ствари: земља у countries јесте она у којој прихватамо то име са точионика, док priced_countries показује где га извор заиста котира, па је priced_here са вредношћу 0 прави одговор, а не рупа у одговору. Уз то стижу и coverage_measured_at и coverage_note, а Cache-Control пада са 24 сата на 6, да одговара учесталости поновног израчунавања.

Препознаје се и више локалних имена са точионика, међу њима Klimadiesel 90 (HVO100) и HVO Diesel, Erdgas и Metano, Autogas и Autogaz, DEF за AdBlue, као и низ брендираних имена премијум дизела и бензина. Редослед препознавања је непромењен, а поклапање остаје тачно, тако да ниједно име које је раније радило данас не значи нешто друго, док ново име може највише да празан одговор претвори у одговор са ценама. Истовремено су референтна документација и описи крајњих тачака исправљени на свих 25 језика сајта.

Cheapest Fuel (/api/v2/data/fuel-cheapest) je vraćao najbliže stanice po redosledu udaljenosti umesto najjeftinijih. Pošto se rangiranje primenjivalo pre nego što je rezultat skraćen na vaš limit, najjeftinije pumpe u vašem radijusu su mogle potpuno da izostanu iz odgovora. Rangiranje je sada ispravno: prvo najjeftinija cena za traženu vrstu goriva, u slučaju izjednačenja pobeđuje bliža stanica, a stanica bez cene za tu vrstu goriva ide na kraj liste. Ništa se ne menja u samom zahtevu — ni parametar, ni verzija.

Odgovori za gorivo u v2 su takođe dokumentovani onako kako se zaista vraćaju: stanice stižu unutar data.stations[], po jedan unos za svaku fizičku stanicu, sa svakom vrstom goriva ugnježdenom u objektu prices (price, currency, local_name, updated_at, age_hours, stale), kao i station_ref, grades, total_found i notices. Referentna dokumentacija za Nearby Fuel Stations i Cheapest Fuel i dalje je opisivala stariju ravnu listu redova data.data[].

На страници за наплату (месечна картица) доступна су два додатка уз било који план, без његове промене: Додатни позиви прогноза — +100 позива прогноза и статистике дневно по блоку, €2 месечно по блоку, до 10 блокова; и Додатне земље — +1 земља за пријаву по јединици, €2 месечно за сваку. Промена количине приказује тачну сразмерну понуду пре него што било шта буде наплаћено.

Од 10. новембра 2026. сваки план укључује одређен број пријављених земаља: Explorer и Student 4, Starter 10, Pro и више неограничено. Од тог датума неће моћи да се сачува пријава дужа од плана плус купљене додатне земље; картица Налог већ приказује ваш лимит, а налози који га већ прекорачују виде предлог на контролној табли. Пре 10. новембра ништа се не мења.

API пешчаник сада означава сваку крајњу тачку на списку њеном класом квоте (Тежак / Стандардни), приказује трошак квоте за изабрану верзију пре него што било шта покренете, а после позива показује колико би исти позив коштао из ваше продукцијске квоте — укључујући формулу ceil(N ppids × M sub-products / 2) која се користи за позиве облика /multi.

Ово је приказ само за читање: сами позиви у пешчанику скидају се са одвојеног тест-буџета пешчаника, никада са ваше продукцијске квоте.

Од данас, све што смо јавно најавили као повучено затворено је за програмерске налоге направљене на дан најаве или касније. Ако је ваш налог постојао пре најаве, ништа се не мења — задржавате пун прелазни рок, све до датума повлачења наведеног у уносу који га је најавио.

Зашто ово правило постоји. Дана 24. августа 2026. најавили смо да се truck-bans v1 повлачи 8. септембра 2026. Два налога регистрована неколико дана после те најаве изградила су своју интеграцију на v1 и дошла на неколико сати од 410, а да их ниједан наш имејл никада није стигао: и најава и серија обавештења претходиле су њиховој регистрацији. Ништа у API-ју их није спречило да преузму верзију за коју смо већ рекли да нестаје. То је био наш пропуст, а ово је исправка: не можете изнова почети да користите нешто чије је уклањање већ заказано.

Како то изгледа. Такав позив се одбија са 410 Gone и кодом грешке version_closed_to_new_accounts. Порука наводи датум повлачења, датум најаве и верзију коју треба користити уместо ње. То је намерно другачији код од version_sunset, који добија сваки налог када прође сам датум повлачења — подршка може да разликује „закаснили сте да почнете“ од „овога више нема ни за кога“ без читања лога.

Стечено право одређује се према датуму отварања налога, а не према првом позиву. Ако сте се регистровали пре најаве, али тек сада почињете интеграцију, и даље добијате пун прелазни рок: могуће је да сте све време развијали на томе.

На снази од сада за truck-bans v1 (најављено 24. августа 2026, повлачи се 8. септембра 2026), и аутоматски за свако повлачење које најавимо од сада па надаље. Од вас се не тражи ништа ново: сваки одговор на верзији која се повлачи већ носи заглавља Deprecation, Sunset и Link: rel="successor-version", па нова интеграција може да види повлачење које долази без читања ове странице.

Наставак јучерашње промене у v4 (тикет за програмере #105). Листе destination раздвојене зарезима у v1 и v2 и даље раде, али сада подлежу истом року као destination=all: обоје престаје 2026-10-06 (до тада заглавља Deprecation/Sunset, потом 400 destination_list_removed, које наводи /api/v4/ као замену). Постојећа провера ограничења од 10 ставки на листама са зарезима остаје непромењена до тог датума.

v4 остаје при једном одредишту по позиву — то се данас није променило. Променило се само како се саопштавају v1/v2: грешка 400 за destination=all више не предлаже листу са зарезима као пут миграције (угасила би се истог датума), већ упућује право на v4.

Исправка документације: пример за v4 на овом сајту раније је гласио /api/v4/data/border/1/2,3,4/9 — листа са зарезима, коју v4 одбија. Сада је /api/v4/data/border/1/2/9. Свако ко је копирао стари пример добио би 400 при првом позиву; извињавамо се.

Нови преведени кључ product_border_v4_p_destination излази на свих 25 језика сајта и изричито наводи правило једног одредишта у v4, уместо да се ослања на формулацију из v1/v2.

/api/v4/data/border/{origin}/{destination}/{crossing_type} је од данас у употреби. Три ствари се мењају у односу на v2 и заједно су разлог зашто је ово нова верзија, а не измена.

1. Више нема destination=all. Наши подаци се лиценцирају по земљи (Услови Developer API, одељак 7), а џокер који се шири на "сваког суседа за кога имамо податке" враћа земље за које ваш налог можда није одобрен — а у самом захтеву ништа то не показује. У v4 сами наводите земљу.

2. Једна одредишна земља по позиву. /api/v4/data/border/1/2/9 тражи једну границу. Листе са зарезима се не прихватају: пошаљите 1/2/9, 1/3/9 и 1/4/9 као засебне позиве. Листа са зарезима или all одговара са 400 и наводи тачне позиве које треба послати, тако да ништа не отказује нечујно.

3. Једна шифра за камионе. v1 и v2 су теретни саобраћај делили на 8 (Freight Transport) и 9 (Freight Transport до 7,5 t). Та подела стварно постоји на прелазу, али ниједан интегратор не може да поступа по њој: тражење шифре 9 од v2 на граници UA-PL враћало је 21 од 70 камионских прелаза, а ништа то није наводило. v4 на 9 одговара свим камионским тракама и прихвата 8 као алијас за 9. Сваки ред носи сопствени crossing_type, па спојени одговор остаје проверљив.

У v1 и v2 destination=all наставља да ради до 2026-10-06 и до тада носи заглавља Deprecation / Sunset. Од тог датума те верзије и на all одговарају са 400 — остатак v1 и v2 остаје нетакнут и доступан. Исти датум важи и за остале пречице за све земље: travel-matrix без ?dest=, bus-carriers са ?ppid=all и fuel-grades без ?country=.

v3, најављен раније данас, замењен је верзијом v4. v3 се од v4 разликовао само по томе што је и даље прихватао листу са зарезима, а ниједна интеграција не користи тај облик. URL-ови верзије v3 и даље одговарају, па ништа написано за њих не престаје да ради, али v3 није документован и неће се даље развијати — пређите на v4.

Све остало у v4 је као у v2: усмерени редослед путање, direction{from,to}, stale и ?max_age_min=.

Нумерички идентификатори у /border/{origin}/{destination}/{crossing_type} никада нису били објављени као табела, па су их интегратори реконструисали из временских зона и примера URL-ова. Сада се налазе у документацији, под насловом Шифре земаља и типова возила, и генеришу се из истих табела на основу којих API проверава захтеве — идентификатори земаља са границама које свака обухвата и сваки crossing_type са ознаком коју API враћа.

Док смо их објављивали, открили смо да sandbox и метаподаци крајњих тачака описују 8 као "truck<7.5t", а 9 као "truck". То је обрнуто: API означава 8 као Freight Transport, а 9 као Freight Transport до 7,5 тона, и одувек је тако. Ако сте шифру за камион изабрали према напомени уз параметар, филтрирали сте супротну траку од оне коју сте желели. Исправљено је свуда, а v3 у потпуности уклања тај избор.

Услови API v1.1 замењују v1.0 пре него што је ступио на снагу и примењују се од 2026-10-06. Прихватите их на својој контролној табли.

Одељак 7 сада прецизира шта је Тржиште: земља чије податке користите — она у којој се налази гранични прелаз или граница коју тражите — а не земља у којој живе ваши корисници. Наша контролна табла је на различитим местима наводила обе ствари; примена је увек значила прву.

Две измене у вашу корист. Земље које су већ одобрене за ваш налог остају употребљиве док је каснија измена на разматрању (додавање земље више не суспендује оне које већ имате). И ако на пријаву тржишта не одговоримо у року од 5 радних дана, важе пуна ограничења вашег плана док не одговоримо.

Одељак 10.3 сада одговара ономе што контролна табла заиста тражи, а одељак 13.2 наводи основу доступности коју меримо и можемо да вам покажемо.

Три производа сада носе додатно поље data_quality (high или low) које означава да ли је очитавање стварно осматрање или процена модела без живог извора бројања на том прелазу: queue (на snapshot највишег нивоа и на сваком историјском реду у data[] — нема га на редовима прогнозе), update-info (на омотачу одговора) и multi (на оба под-објекта, queue и update_info, по граничном прелазу). Ово није нов сигнал — сама ознака је интерно већ постојала — али никада није била изложена, па је потпуно моделован прелаз изгледао исто као и директно мерен. is_realtime је намерно непромењен: за моделоване редове и даље даје true, а промена тог значења била би прекидна измена нивоа v2, коју овде не правимо.

Такође у овом издању: производ queue-advanced више не прослеђује сирове временске податке са извора. weather_main, temperature и wind_speed замењени су изведеним пољем condition_code (скала опасности 0–5, null када нема доступних временских података), као и пољима condition и severity.

Od 2026-08-30 jedan /api/v1/data/multi zahtev dobija odgovor za najviše 5 graničnih prelaza. Poziv koji navodi više PPID-ova se ne odbija: i dalje vraća 200, ali odgovor dobijaju samo prvih 5 ID-ova u ?ppids=. Preostali ID-ovi se zanemaruju, vraćaju se u meta.ppid_cap.ignored i ne skidaju se s vaše kvote — poziv se naplaćuje prema onome što zaista vrati.

Dok poziv prekoračuje ograničenje, odgovor nosi zaglavlje X-Devapi-Warning: multi_ppid_cap i blok meta.ppid_cap sa poljima cap, enforced_from, enforced, ppids_asked, ppids_answered i ignored[]. Do 2026-08-30 ta polja se pojavljuju sa vrednošću enforced: false i sa punim skupom rezultata, pa nadolazeću promenu možete videti u sopstvenim logovima.

Popust na kvotu od polovine ostaje nepromenjen. Podelite svoje granične prelaze u grupe po 5 i u svom uobičajenom ciklusu osvežavanja šaljite po jedan poziv za svaku grupu; za često proveravanje samo dužine reda i svežine podataka, update-info ostaje jeftiniji proizvod standardne klase.

Израчуната украјинска забрана због врућина — враћа се уз include_ua_heat, а за country=UA аутоматски — сада одговара за опсег датума који тражите. Раније је враћала наредних седам дана без обзира на date_from и date_to, па је децембарски опсег тихо враћао редове ове недеље. Забрана се рачуна из временске прогнозе, а не чита из календара забрана, па има две границе које календар нема: не гледа уназад и завршава се тамо где се завршава прогноза. Ваш опсег се сада пресеца са оним што прогноза заиста покрива, а ново поље ua_heat_ban.forecast_horizon наводи последњи доступан датум. Опсег изван тог хоризонта не враћа редове и објашњава зашто у пољу summary — што није исто што и „нема забране“. Одговори v1 су непромењени.

Облик одговора досад нигде није био описан — једини начин да се сазна шта производ враћа био је да се позове. Сада на страници сваког производа, испод табеле параметара, стоји табела Поља одговора са кратким описом сваког поља; поља елемената листе приказују се као items[].name, а поља на нивоу коверте (usage, meta, snapshot, resolved_location) без префикса. Описано је 40 од 42 производа: два још непокренута (weather, road-quality) намерно остају без описа. Иста табела објављује се и у нашем јавном огледалу документације на GitHub-у.

Сваки производ за гориво сада прихвата локални назив горива, а не само наш интерни запис: ON у Пољској, Nafta у Чешкој, Gázolaj у Мађарској, Motorină у Румунији, ДП у Украјини, Motorin у Турској, Gasóleo у Португалији и Шпанији. Назив се тумачи прво према земљи — „95“ је E10 на данској пумпи, а E5 на пољској — зато шаљите country заједно са локалним називом или координате по којима можемо да сместимо тачку. У одговору се враћају fuel_type (канонски), fuel_type_requested (онако како сте га уписали) и fuel_type_local. Назив који не можемо да сместимо никада не мењамо подразумеваним горивом: одговор стиже празан и то отворено каже.

Цела табела је сада засебан производ — GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON] — наша канонска горива и њихови локални називи у 41 европској земљи, укључујући тржишта за која не објављујемо цене. Осим тога, ниво земље и региона производа fuel и fuel-local добио је објекат grades који сваки ценовни кључ повезује с горивом и с његовим називом на пумпи.

Proizvod truck-bans sada odgovara za određeni datum ili opseg datuma na adresi /api/v2/data/truck-bans. Do sada je uvek vraćao narednih 7 dana i ignorisao svaki poslati datum, pa je sastavljanje kalendara zahtevalo po jedan zahtev dnevno — a na planu sa dva zahteva u sekundi većina njih se odbija sa 429 qps_exceeded.

Koristite ?date=YYYY-MM-DD za jedan dan ili ?date_from= i ?date_to= za opseg. Oba kraja su uključena i bilo koji se može izostaviti: početak je podrazumevano danas, kraj je početak plus 7 dana. Prozor može obuhvatiti najviše 92 dana — duži se odbija sa 400 date_range_too_long, umesto da bude tiho skraćen. Ovo je kalendar okrenut budućnosti: prozor može početi najviše 7 dana unazad, a stariji datumi se odbijaju umesto da budu posluženi — pokrivenost se prostire unapred do 31. decembra 2028. u 23 zemlje.

Svaki odgovor sada sadrži objekat window koji imenuje tačno obuhvaćeni opseg. To je dodatno polje i šalje se i u v1, pri čemu v1 zadržava nepromenjen svoj fiksni prozor od 7 dana. Napomena: include_ua_heat uvek pokriva narednih 7 dana, koji god prozor da tražite — računa se iz vremenske prognoze, a ne iz kalendara zabrana. Podsećamo da se v1 ovog proizvoda povlači 8. septembra 2026.

Dva povezana poboljšanja u celom API-ju: svaki parametar koji proizvod ne prihvata sada je naveden u ignored_params u odgovoru umesto da bude tiho odbačen, a greške provere iz servisa podataka stižu do vas onako kako su napisane, sa mašinski čitljivom oznakom u error.reason.

Три исправке квалитета одговора настале ревизијом гејтвеја (тикет #43).

Заглавље X-API-Key се сада прихвата упоредо са Authorization: Bearer и ?key=. Ако ваш HTTP клијент шаље кључеве кроз заглавље под називом X-API-Key, то сада ради — раније је било тихо игнорисано, а позив је одбијан као missing_api_key. Authorization: Bearer остаје документован и препоручен облик.

Порука о грешци због недостајућег кључа сада наводи сва три начина аутентификације (Bearer заглавље, X-API-Key заглавље или ?key=) уместо да само упућује на страницу за регистрацију.

Директоријум checkpoints сада носи has_day_stats у сваком реду — додатну логичку вредност која говори да ли Best Time to Cross (day-stats) API има податке за тај гранични прелаз. Day-stats постоји само за део надзираних прелаза; проверите ову заставицу пре слања упита да бисте избегли предвидиве 404 одговоре. Постојећа поља су непромењена.

У документацији је исправљено и следеће: производ road-conditions је одувек поштовао параметар lang за локализацију ознака — само није био наведен.

Две исправке и једна нова верзија за производ truck-bans.

Земље раздвојене зарезом сада раде. ?country= прихвата листу од највише 3 ISO-2 кода, на пример ?country=DE,RO. Дужа листа се одбија са 400 too_many_countries уместо да буде тихо скраћена — ово је календар забрана по земљи, а не масовни фид. Раније ово није радило: раздвојник је уклањан, па је DE,RO читан као јединствени токен DERO, није се поклапао ни са чим и враћао је success: true уз total_bans: 0 — самоуверено “нема забрана” за две земље које су заједно имале 22. Ако сте то заобилазили слањем по једног захтева за сваку земљу, сада један захтев покрива све и троши један позив уместо неколико.

Одговори сада пријављују сопствену потпуност. Три додатна поља — returned, total_available и truncated — говоре вам да ли је одговор ограничен. Нарочито позив без опсега враћа ограничен исечак, а до сада ништа у одговору то није наговештавало. total_bans задржава постојеће значење (редови у овом одговору), па се ништа што већ парсирате не мења.

v2 има опсег по земљи. На /api/v2/data/truck-bans, ?country= је обавезан, а захтев без опсега се одбија са 400 scope_required — овај производ је календар забрана по земљи, а не масовни фид. v1 је данас непромењен — и даље прихвата позив без опсега и и даље враћа истих ограничених 50 редова као и увек, тако да се тренутно ништа што имате у раду не квари. v1 овог производа се повлачи 8. септембра 2026. Ради нормално закључно са 7. септембром; од 8. септембра захтев ка v1 се одбија са 410 Gone и поруком која упућује на v2. До тада сваки v1 одговор носи Deprecation: true, заглавље Sunset са тим датумом и заглавље Link које именује наследну верзију, тако да клијентска библиотека може да прикаже рок а да нико не прочита ову страницу. За миграцију: промените сегмент верзије у /api/v2/data/truck-bans и проследите ?country=.

Једна исправка документације: параметар date је уклоњен. Био је наведен дуго времена, али га сервис никада није читао, па је сваки захтев који га шаље тихо добијао подразумевани прозор од 7 дана уместо траженог дана. Да бисте изабрали дан, филтрирајте низ upcoming_bans по његовом пољу date. Такође, ISO-3 код као што је DEU се више не разрешава у назив земље у сажетку, где је производио обмањујуће “No truck ban data for: Germany.”

Proizvod truck-bans sada vraća saobraćajna ograničenja na nivou države za još pet zemalja: Belgiju (BE), Belorusiju (BY), Crnu Goru (ME), Severnu Makedoniju (MK) i Švedsku (SE). Postojeća pokrivenost za Bugarsku, Grčku i Portugal proširena je i osvežena — grčka ograničenja sada sežu do septembra 2027. godine, a Portugal je ponovo popunjen.

Struktura odgovora je nepromenjena. Novi redovi nose iste ključeve kao i svaka druga zabrana: date, time_from, time_until, restriction_type, restriction_details, min_weight_tons i details_url. Kada ograničenje važi samo pod određenim uslovom — beloruske letnje zabrane, na primer, važe iznad 25 °C — taj uslov je naveden u polju restriction_details, pa pročitajte to polje pre nego što upozorite vozača. min_weight_tons je null kada se pravilo odnosi na klasu prevoza (opasne materije), a ne na tonažu.

Proizvodi fuel-stations i fuel-cheapest sada vraćaju cene po pojedinačnoj stanici u Poljskoj. Pokrivenost je delimična — područje Trograda (Gdanjsk, Gdinja, Sopot) — pa je Poljska označena u novom, dodatnom nizu coverage.sparse_coverage pored postojeće liste coverage.station_countries. Zemlja navedena u sparse_coverage ima podatke o stanicama samo za deo svoje teritorije; upit na drugom mestu u toj zemlji vraća praznu listu zajedno sa napomenom o pokrivenosti, potpuno isto kao i ranije. Poljske cene su izražene u PLN.

I poruka o grešci pri masovnom upitu je jasnija: kada nedostaje lat, poruka scope_required sada upućuje na proizvod fuel (?country=XX) za prosečne cene na nivou zemlje.

GET /api/v2/data/fuel-local?lat=&lon= sada razrešava cenu kroz tri nivoa umesto dva: station, zatim region, zatim country. Novi srednji nivo postoji za Ukrajinu, gde cene po pojedinačnim stanicama nigde ne postoje: tačka u Ukrajini sada dobija prosek svoje oblasti umesto nacionalnog proseka i vraća se na nacionalni prosek samo kada za oblast nema kotacija.

Odgovor nivoa region sadrži kod oblasti (ISO 3166-2 vrednost kao što je UA-46), region_name i region_center_dist_km, kao i iste cenovne ključeve kao nivo zemlje. I dalje grananje koda radite prema resolution, nikada prema obliku odgovora; odgovori station i country ostaju nepromenjeni.

Novi endpoint GET /api/v2/data/fuel-local?lat=&lon= vraća najbolju dostupnu cenu goriva za bilo koju tačku u Evropi. Tamo gde imamo podatke po pojedinačnim stanicama odgovara cenama najbližih stanica, u suprotnom nacionalnim prosekom zemlje u kojoj se tačka nalazi — uključujući Ukrajinu, gde cene po pojedinačnim stanicama nigde ne postoje.

Svaki odgovor sadrži polje resolution, koje navodi nivo koji je odgovorio: station (lista stanica sa distance_km, svaka u sopstvenoj valuti) ili country (jedan objekat sa nacionalnim prosecima). Grananje koda radite prema resolution, nikada prema obliku odgovora. Dostupno od /api/v2/ nadalje; fuel, fuel-stations i fuel-cheapest ostaju nepromenjeni.

Производи fuel-stations и fuel-cheapest сада покривају знатно више пумпи у Немачкој, а цене се освежавају током целог дана — укључујући и рурална подручја. Параметар fuel_type прихвата 13 врста горива: diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 и lng. Када ниједна пумпа не одговара упиту, одговор садржи објекат coverage са списком земаља за које постоје подаци о пумпама.

Параметар radius= се сада прихвата као компатибилан алијас за radius_km у свим производима који га документују. Производи fuel-stations и fuel-cheapest враћају додатни објекат coverage (списак земаља са пумпама и напомена) уместо тихог празног резултата када ниједна пумпа не одговара. Објекти граничних прелаза у route-plan сада садрже додатни кључ wait_basis (car_lane наспрам vehicle_lane), па клијенти знају када подаци о чекању за камионе заправо долазе са траке за путничка возила. Упаривање камионских граничних прелаза дуж руте знатно је прецизније: резервни подаци са путничке траке за парове прелаза без података о теретној траци, заштита од погрешног смера, строжи праг удаљености и уклањање дупликата прелаза на истој позицији. Све промене су додатне, без промена које нарушавају компатибилност.

Почетна страница за програмере сада има секције са сидрима (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) уз навигацију за брзи прелазак, а свака картица производа води на сопствену страницу документације. Нова секција Mobile apps представља Kordon Online и Truck Bans са везама ка Google Play. Допуна превода: историја наплате, грешке при пријави, sandbox везе и дугме за избор плана сада су локализовани на свих 25 језика.

Одговор flota beacon-a (POST /api/v1/fleet_position.php) сада укључује низ messages који доставља поруке на чекању од власника ка возачу. Нови live JSON фид само за власнике (?ajax=live) и картица "Поруке возачима" на контролној табли flote. Нова страница за позивање возача /{lang}/get-nakbus (25 језика).

Локализовани су наслов, опис (title, desc) за product_fleet_vehicles/live/history и параметри fleet-history на свих 25 језика developer портала.

/api/v1/data/truck-bans сада враћа исти скуп поља највишег нивоа без обзира на то који упит је покренуо одговор. Раније је упит за земљу без календарских забрана, непрепознат ppid, или уобичајено подударање у бази података могао да изостави различита поља (нпр. country, covered_countries, ppid). Сада сваки одговор доследно укључује 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 и upcoming_bans (null или празно тамо где није применљиво), што поједностављује обраду на страни клијента.

Девет нових производа по услузи. Они засновани на локацији прихватају lat/lon или city + country (град геокодирамо уместо вас): /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 (станице рангиране по цени за одређени тип горива) и /api/v2/data/internet-points; резултати садрже distance_km и ограничени су параметром radius. /api/v2/data/vignettes одговара да ли земља захтева винјету, са актуелним ценама. Постојећи производ pois сада подржава lon и radius као што је документовано, а режим mode=nearest производа fuel такође прихвата lon. Свих девет је доступно у sandbox-у.

Свака забрана у /api/v1/data/truck-bans сада укључује restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (тачан обим или путеве на које се односи) и min_weight_tons. details_url сада води на странице по земљи на nakordoni.eu. Нови опциони параметар lang бира језик назива земаља и резимеа; подразумевани је сада енглески.

Неисправан ?ppid= сада враћа прави разлог уместо кратког "Request failed": грешка именује параметар, очекивани формат id_<number> и упућује на /api/v1/data/checkpoints. Табеле параметара за stats, forecast, update-info, weather и bus-carriers сада приказују пример id_13 на свих 25 језика.

Редизајнирано окружење портала (горња трака, бочна трака са иконама, KPI табла, распореди са картицама) сада је подразумевано за све пријављене развојне налоге — раније него што је планирано пуштање 10. августа. Употребите ?v=1 да се у сваком тренутку вратите на класични распоред.

Све странице портала за програмере — почетна, документација, контролна табла, AI Studio, песак, тикети, захтеви, извоз, возни парк, вести, дневник измена и странице налога — више не учитавају никакве рекламне скрипте ни рекламне просторе. Ово важи за цео портал, а не само за пријаву и регистрацију као раније.

Isplanirajte celo putovanje preko granice jednim pozivom: /api/v2/data/route-plan vraća rutu, granične prelaze koji zaista leže na njoj sa trenutnim redom ili prognozom za vreme vašeg dolaska, i stajanja koja vozač zaista pravi — odmor, obrok, gorivo — na jednoj vremenskoj osi.

Granica je deo te ose. Dugačak red se računa kao pauza koja je ionako sledovala i resetuje vreme za volanom, pa se tročasovno čekanje nikada ne prikazuje kao tri sata plus pun set pauza koje niko nije napravio. Za putnička vozila važi model bezbedne vožnje; autobusi i kamioni dobijaju obavezan odmor po EU 561/2006, a servisno vreme autobusa kalibrisano je na više od 1000 licenciranih međunarodnih redova vožnje. Dodajte stop_places=1 da svako stajanje dobije pravi odmorište ili pumpu, i via=lat,lon da rutu provedete kroz drugi prelaz.

Ново у менију портала: Презентација — жива, увек актуелна презентација nakordoni платформе података, прилагођена вашем тржишту (осигурање, путовања, логистика, превозници, медији, навигација, гориво, финтех, јавни сектор или лични пројекти). Приказује стварне 30-дневне обиме платформе, ваше сопствено коришћење API-ја, статистику времена одзива и ограничења, као и препоруку плана када ваши позиви достигну границе бесплатног нивоа. Изаберите или потврдите своје тржиште (или тржишта) на страници, у профилу — или приликом регистрације. Отвара се аутоматски при првој посети; аутоматско отварање можете искључити на самој страници.

Ако асистент има укључен канал, али позив не носи контекст који том каналу треба — на пример queue без ppid— канал се сада прескаче пре било каквог захтева и не наплаћује се. Раније је ипак био позван, отказивао би и свеједно коштао једну јединицу. Студио приказује шта је сваком каналу потребно, поново рачуна цену док попуњавате контекст и означава резултате ✓ извршен / ⊘ прескочен, без наплате / ✕ неуспео; API враћа data.feeds_skipped , које вам тачно каже који параметар да проследите.

Одговори више не помињу канале, изворе података ни било шта техничко: канал који недостаје је највише једна обична реченица крајњем кориснику, никада интерни назив. Канали само са опционим филтерима (као што је fuel сужен на земљу за коју немамо податке) сада се враћају на широки скуп података уместо да не врате ништа.

Ново: /{lang}/developers/studio. Направите AI асистента који одговара из вашег садржаја и наших живих граничних података. Дајте нам свој markdown или само наведите странице, а ми ћемо их преузети и индексирати — ви одржавате само сопствене фајлове. Изаберите које наше канале сме да користи (ред, прогноза, алтернативе, дневна статистика, гориво, забране за камионе, трговачке недеље, празници, стање путева, аутобуски превозници, POI, валута), изаберите ниво модела (брзи / уравнотежени / про — управо он одређује цену), напишите сопствена упутства са чуварима места {{feed.slug}} који тачно одређују где наши подаци стижу у одговор, и додајте сопствену завршну реченицу која се додаје сваком одговору. Готови обрасци: лични путни асистент, радни/теретни асистент, асистент за продају осигурања и Зелене карте.

Тестирајте га у студију (30 одговора дневно, одвојено од ваше API квоте), а затим га у продукцији позивајте на GET /api/v2/data/assistant-custom?assistant_id=N&q=…. Цена по одговору = јединице нивоа модела + 1 јединица по укљученом каналу, враћа се у X-Devapi-Units. Производ постоји само у v2 — v1 адреса враћа unsupported_version. Постојећи производ assistant остаје непромењен.

Сваки асистент ради под политиком садржаја платформе која има предност над вашим упутствима: без представљања као службено лице, без помоћи у избегавању граничне или царинске контроле, без измишљених бројева, без псовки. Проверавају се и упутства и одговори; блокирани позиви се бележе.

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

Преименовање у „Live Queue & Freshness API“ описано испод заправо није стигло до странице документације . Страница исписује назив сваког производа преко претраге превода, која посеже за насловом крајње тачке само када превод не постоји — а превод је већ постојао, замрзнут на старом називу, на свих 25 језика интерфејса. Од сада има предност над сваким будућим ажурирањем основног назива, док се и он сам не ажурира.

Кључ превода је преименован на свих 25 језика, па се страница документације сада поклапа. Нема измена крајње тачке, параметара ни одговора — само текст наслова.

Ако често тражите податке о живом реду, можда трошите тешку квоту без потребе. /update-info је стандардне класе и већ враћа тренутну вредност:

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

Враћа queue_now, freshness, age_minutes, is_realtime, status, timestamp и timezone. Користите је за често освежавање на терет своје стандардне дневне квоте, а /queue, /multi и /forecast (све тешке класе) сачувајте за случајеве када вам требају wait_min, поља тренда или историја.

У самој крајњој тачки ништа није промењено — само у њеној документацији. Била је наведена као „Data Freshness API“, а опис је помињао само оцену свежине, никада queue_now, па се лако превиђала. Сада се зове „Live Queue & Freshness API“, са изричито наведеним пољима која враћа. Хвала програмеру који је на то указао.

Неки неуспели захтеви враћали су HTTP 200 са ok: true и грешком скривеном унутар data — тако документовани образац if (!ok) throw није могао да их открије, а позив се свеједно наплаћивао. Такви позиви сада враћају HTTP 400 са ok: false и исправним error.code / error.message, како је документовано. Уочено код fuel-cities са неподржаном земљом и код travel-matrix са неисправним координатама.

Одвојено: недостајући обавезни параметар враћао је 500 internal_error уместо 400 bad_request (тело одговора 4xx интерне услуге одбацивало се пре него што би се прочитао њен статус). Сада враћа 400 bad_request са поруком интерне услуге — нпр. search без ?name=.

Успешни одговори су непромењени до бајта — иста поља, исти параметри, иста цена квоте. Ако се ваш клијент већ грана по ok, ништа не морате да мењате. Ако је ok игнорисао и читао data директно, сада ће видети коверте грешака на позивима који су ионако увек падали.

Исправљена је грешка због које је /multi могао да врати погрешан број у реду за неке прелазе — углавном балканске и на граници Мађарска–Србија — кад год му је кеш био хладан. Резервни пут је читао табелу која за те прелазе не садржи податке о реду и пријављивао неповезане вредности као број аутомобила. Измерени примери: прелаз са 12 аутомобила пријављивао је 6, а неколико њих са стварним редовима пријављивало је 0.

Три промене које можете приметити:

• found: false сада значи да заиста нема свежих података о реду. Раније сте могли добити found: true са измишљеним queue_now: 0.
• wait_status, trend_percent и trend_direction сада се враћају и на хладним захтевима — раније су били null .
• Крајња тачка прелази на резервни пут и када је њен кеширани снимак застарео (старији од 24 ч), не само када недостаје.

Нема измена параметара захтева, цене квоте нити структуре одговора.

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