Ιστορικό αλλαγών 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.

Διορθώθηκε ένα σφάλμα λόγω του οποίου κάθε κλήση /multi χρεωνόταν δύο φορές — μία με έναν γενικό έλεγχο 1 μονάδας και ξανά με τον δικό της τύπο μεταβλητού κόστους του endpoint (N PPID × υπο-προϊόντα). Μια κλήση κοστίζει πλέον ακριβώς ⌈(N×M)/2⌉ μονάδες όπως τεκμηριώνεται, χωρίς επιπλέον χρέωση.

Επίσης προστέθηκε ένα σήμα κλάσης ορίου (Standard/Heavy) σε κάθε προϊόν στη σελίδα τεκμηρίωσης, ώστε να φαίνεται με μια ματιά ποιο ημερήσιο όριο χρησιμοποιεί ένα endpoint.

Οι παράμετροι country και countries συγχωνεύτηκαν σε μία (1-15 κωδικοί χωρισμένοι με κόμμα). Νέα παράμετρος compare_to: σύγκριση ίδιων vs. διαφορετικών αργιών μεταξύ χωρών, συνδυάζεται με upcoming+days. Η lang δέχεται πλέον πολλές γλώσσες (προσθέτει ένα αντικείμενο names). Το days=0 ή η παράλειψή του σημαίνει πλέον χωρίς όριο στη λειτουργία upcoming.

Επίσημες αργίες ανά ευρωπαϊκή χώρα — ημερομηνίες, τοπικές ονομασίες και τύπος. Στηρίζεται στην ίδια υπηρεσία Nager.Date / OpenHolidaysAPI (με τοπικά υπολογισμένο ημερολόγιο για το Κοσσυφοπέδιο) που τροφοδοτεί τη σελίδα ημερολογίου αργιών του nakordoni.eu και τους ημερολογιακούς παράγοντες του συστήματος πρόβλεψης.

• ?country=PL&year=2026 — πλήρης ετήσια λίστα αργιών για μία χώρα
• ?upcoming=1&days=30 — απλή λίστα των επερχόμενων αργιών σε πολλές χώρες
• Χωρίς παραμέτρους — ευρετήριο ενός βασικού συνόλου χωρών με την επόμενη αργία για την καθεμία

Προστέθηκε το προϊόν currency — ισοτιμίες με βάση το EUR για PLN, CZK, HUF, USD, GBP, CHF, NOK και UAH, από την πηγή Frankfurter (ΕΚΤ) και αποθηκευμένες στην cache για 6 ώρες. Χωρίς παραμέτρους, επιστρέφει πάντα τον πλήρη πίνακα ισοτιμιών. Δείτε την τεκμηρίωση.

Ενσωματώστε τις ζωντανές ευρωπαϊκές απαγορεύσεις κυκλοφορίας φορτηγών στον δικό σας ιστότοπο — ένα δωρεάν widget iframe με 3 σχέδια (light, dark, board), 5 γλώσσες (en, uk, pl, de, ru), προαιρετικό φίλτρο ανά χώρα και ζωντανή κατάσταση «ενεργό τώρα». Δεν απαιτείται κλειδί API. Ρυθμίστε και αντιγράψτε τον κώδικα στο nakordoni.eu/en/for_truck_drivers/traffic_bans/widget. Προτιμάτε ακατέργαστα δεδομένα; Το προϊόν API truck-bans και η δημόσια ροή JSON παραμένουν διαθέσιμα.

Τρεις προσθήκες, όλες συμβατές προς τα πίσω — το v1 παραμένει αμετάβλητο.

Έκδοση ανά endpoint. Υπάρχει πλέον ένα βασικό URL /api/v2/. Λειτουργεί ανά endpoint: μόνο τα endpoint που πραγματικά άλλαξαν συμπεριφέρονται διαφορετικά υπό το v2· κάθε άλλο endpoint σερβίρει διαφανώς την απόκριση v1 (έτσι το /api/v2/data/queue = τα ίδια δεδομένα με το v1, απλώς με "api_version":"v2"). Δεν χρειάζεται να μεταφέρετε endpoint που λειτουργούν.

Το border v2 είναι κατευθυντικό. Η σειρά στη διαδρομή είναι η κατεύθυνση μετακίνησης:

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)

Κάθε checkpoint αποκτά επίσης ένα αντικείμενο direction {from,to} και ένα boolean stale, ενώ το ?max_age_min=N επιστρέφει μόνο τα πρόσφατα ενημερωμένα σημεία διέλευσης. (Το v1 border εξακολουθεί να επιστρέφει και τις δύο πλευρές των συνόρων ανεξαρτήτως σειράς — αμετάβλητο.)

Διαδραστικό Sandbox. Οι συνδεδεμένοι προγραμματιστές μπορούν πλέον να δοκιμάσουν οποιοδήποτε endpoint από το πρόγραμμα περιήγησης στο Developers → Sandbox — επιλέξτε ένα endpoint, μια έκδοση και ένα από τα κλειδιά σας, προσαρμόστε τις παραμέτρους και δείτε τη ζωντανή απόκριση. Η δοκιμή στο Sandbox έχει τον δικό της ξεχωριστό ημερήσιο προϋπολογισμό (50 κλήσεις/ημέρα) και δεν αγγίζει ποτέ το ζωντανό όριο API σας.

Η τεκμηρίωση είναι πλέον χωρισμένη ανά endpoint (Developers → API Docs), με επιλογέα έκδοσης στα endpoint που έχουν περισσότερες από μία εκδόσεις.

Δύο νέοι παράγοντες ενσωματωμένοι στον τύπο του χρόνου αναμονής, δίπλα στις υπάρχουσες προσαρμογές section_mode και καιρού:

• service_rate — μετρημένα αυτοκίνητα/λεπτό που διεκπεραιώνονται αυτή τη στιγμή σε σχέση με τον διαμορφωμένο βασικό ρυθμό του checkpoint. Πολλαπλασιαστικός, περιορισμένος σε 0.5x-1.5x.
• shift_change — η επίδραση της τοπικής αλλαγής βάρδιας των συνοριοφυλάκων στις 08:00/20:00 του checkpoint. Προσθετικός (λεπτά), όχι πολλαπλασιαστικός — εφαρμόζεται μόνο εντός +/-60 λεπτών από μια αλλαγή βάρδιας, απαιτεί ελάχιστο ιστορικό δειγμάτων, περιορισμένος σε +/-120 λεπτά.

Το advanced_wait_min είναι πλέον round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min. Και οι δύο παράγοντες αποτυπώνονται επίσης στο driver_reported.prognosed_advanced_wait_min για ιστορικές συγκρίσεις.

Στο πλαίσιο μιας επισκόπησης ασφάλειας/απορρήτου, τα ακόλουθα πεδία αφαιρέθηκαν — εξέθεταν εσωτερικές λεπτομέρειες υλοποίησης (την ταξινομία των ανάντη πηγών δεδομένων μας, αναγνωριστικά γραμμών βάσης δεδομένων, εσωτερικές σημειώσεις pipeline, αχρησιμοποίητα/νεκρά πεδία) χωρίς πραγματική αξία για το προϊόν:

• id και corrected — αφαιρέθηκαν από τα αντικείμενα γραμμών του queue
• tmin/tpercar — αφαιρέθηκαν από τα queue, border και multi (οι σταθερές του τύπου χρόνου αναμονής· το ήδη υπολογισμένο wait_min/wait_time δεν επηρεάζεται)
• source (ακατέργαστο string, π.χ. "line") — αφαιρέθηκε από τα queue, multi και update-info. Το update-info και το μπλοκ update_info του multi εξακολουθούν να φέρουν source_category/source_label_en (ένα μικρό δημόσιο λεξιλόγιο)· το μπλοκ queue του queue και του multi δεν φέρει πλέον κανένα πεδίο source
• traffic_status — αφαιρέθηκε από το border· ήταν πάντα null και δεν συμπληρώθηκε ποτέ από κανένα μέρος του συστήματος

Εάν η ενσωμάτωσή σας διαβάζει οποιοδήποτε από αυτά τα πεδία, ενημερώστε την — δείτε την τρέχουσα λίστα πεδίων στη σελίδα τεκμηρίωσης του σχετικού προϊόντος.

Η ημερήσια χρήση ορίου (usage.used σε κάθε απόκριση) μπορεί πλέον να είναι δεκαδική τιμή (π.χ. 67.5) αντί για πάντα ακέραιος. Αυτό είναι παρενέργεια του ότι το queue-advanced χρεώνεται με κλασματικό ρυθμό — δείτε παρακάτω. Το usage.limit δεν επηρεάζεται και είναι πάντα ακέραιος. Εάν ο client σας ορίζει αυστηρά το usage.used ως ακέραιο, διευρύνετε τον τύπο ώστε να δέχεται δεκαδικό/float.

Αυτά τα τρία προϊόντα επιστρέφουν πλέον τα ίδια πεδία ζωντανής κατάστασης που εμφανίζει ο ιστότοπος: wait_status (green/yellow/red, με βάση το πρόσφατο ιστορικό αυτού του checkpoint) και trend_percent/trend_direction (up/up-slight/down/down-slight/stable, συγκρίνοντας τις τελευταίες 3 ώρες). Καθαρά προσθετικό.

Οι γραμμές data[] του /api/v1/data/queue είχαν προηγουμένως wait_time: null για τις περισσότερες πηγές — μόνο λίγες ανάντη ροές αναφέρουν απευθείας χρόνο αναμονής. Οι γραμμές χωρίς τιμή λαμβάνουν πλέον την τυπική εκτίμηση tmin + queue×tpercar, επισημασμένη με ένα νέο boolean wait_time_estimated, ώστε να διακρίνετε μια πραγματικά αναφερόμενη τιμή από μια υπολογισμένη.

Το queue-advanced κοστίζει πλέον 1.5 units ανά κλήση αντί για 1 (αντικατοπτρίζοντας τις επιπλέον αναζητήσεις κυκλοφορίας/καιρού/αναφορών οδηγών που εκτελεί) — δείτε το usage.used παραπάνω. Η απόκριση επίσης δεν περιλαμβάνει πλέον τα tmin, tpercar ή total_crossing_time, και το driver_reported είναι πλέον απλώς {wait_min, ts, age_min} — τα προηγούμενα πεδία σύγκρισης πρόβλεψης-πραγματικότητας (prognosed_wait_min, diff_min, historical_section_mode, historical_weather κ.λπ.) αφαιρέθηκαν. Τα section_mode, weather, advanced_wait_min και exceeds_crossing_time παραμένουν αμετάβλητα.

Το /api/v1/data/truck-bans επιστρέφει πλέον, για κάθε χώρα στο bans_by_country, ένα status (active/clear) καθώς και active_window, next_window, local_time και tz — υπολογισμένα στη ζώνη ώρας της εκάστοτε χώρας, ώστε να μη χρειάζεται πλέον να αξιολογείτε μόνοι σας τα ακατέργαστα παράθυρα απαγόρευσης σε σχέση με ένα ρολόι. Η απόκριση προσθέτει επίσης μια λίστα covered_countries ανώτατου επιπέδου και μια χρονοσφραγίδα as_of σε UTC.

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

Καθαρά προσθετικό — τα υπάρχοντα πεδία current_bans/upcoming_bans/bans_by_country παραμένουν αμετάβλητα. Ένα άγνωστο ?country= επιστρέφει πλέον ένα κενό αποτέλεσμα με countries_not_covered αντί για τις απαγορεύσεις κάθε χώρας.

Ένα νέο προαιρετικό προϊόν που προσαρμόζει τον τυπικό χρόνο αναμονής στη ζωντανή ροή κυκλοφορίας και στον καιρό. Επιστρέφει την πλήρη ανάλυση κάθε προσαρμογής.

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

Παρέχεται κατόπιν αιτήματος — ανοίξτε ένα Data ticket από τον πίνακά σας για να το ενεργοποιήσετε.

Το /api/v1/data/border υπολογίζει πλέον σωστά το wait_min (και επιστρέφει τα tmin/tpercar) για κάθε checkpoint στην απόκριση, όπως τα προϊόντα queue και multi. Προηγουμένως αυτό το πεδίο ήταν πάντα null.

Το /api/v1/data/forecast χρησιμοποιεί πλέον αξιόπιστα το μοντέλο ensemble v4 για οποιαδήποτε τιμή prediction_steps (προηγουμένως ορισμένοι μη τυπικοί ορίζοντες μπορούσαν σιωπηλά να επιστρέψουν σε παλαιότερο μοντέλο). Ο παράγοντας καιρού που τροφοδοτεί το ensemble διορθώθηκε επίσης και αντικατοπτρίζει πλέον πραγματικά τις ζωντανές συνθήκες (βροχή, χιόνι, άνεμος, ομίχλη) αντί να αναφέρει πάντα μη διαθέσιμο.

Οι εγκεκριμένοι προγραμματιστές μπορούν πλέον να κατεβάσουν ωριαία μέσα ιστορικά δεδομένα ουρών συνόρων για έως 5 checkpoint (κυλιόμενο παράθυρο έως 90 ημερών) σε μορφή CSV ή NDJSON από τη νέα καρτέλα Data export. Διατίθενται μόνο δημοσιευμένα και ελεγμένα ως προς την ποιότητα δεδομένα· οι χρονοσφραγίδες είναι σε UTC. Χρειάζεστε πρόσβαση; Ανοίξτε ένα Data ticket.

Δεν έχετε ακόμη ιστότοπο; Μπορείτε πλέον να δημιουργήσετε λογαριασμό προγραμματιστή περιγράφοντας πού και πώς σκοπεύετε να χρησιμοποιήσετε τα δεδομένα μας, αντί να υποχρεώνεστε να εισαγάγετε το URL μιας ζωντανής σελίδας. Προσθέστε το πραγματικό URL αργότερα από τον πίνακά σας (Account & data → Το έργο σας), μόλις ο ιστότοπος ή η εφαρμογή σας τεθεί σε λειτουργία — ένας ορατός σύνδεσμος προς το nakordoni.eu σε αυτήν τη σελίδα απαιτείται από τους Όρους μας.

Οι προγραμματιστές μπορούν πλέον να υποβάλλουν τις δικές τους συνοριακές ειδήσεις στη ροή ειδήσεων του Nakordoni. Εάν οι συντάκτες μας τις δημοσιεύσουν, λαμβάνετε ένα ευρετηριάσιμο dofollow backlink προς την υπηρεσία σας (υπογραφή εκδότη + γραμμή πηγής) και μεταφράζουμε το άρθρο και στις 24 γλώσσες δωρεάν.

Ένα άρθρο την εβδομάδα είναι δωρεάν· τα επιπλέον άρθρα αποτελούν πληρωμένη προσθήκη. Επιλέξτε 'ενδέχεται να επεξεργαστούμε ελαφρώς + να προσθέσουμε εσωτερικούς συνδέσμους' ή 'δημοσίευση ως έχει'. Υποβάλετε και παρακολουθήστε την κατάσταση ελέγχου στο Developers → Submit news.

Το Multi-Checkpoint API (/api/v1/data/multi) χρεώνει πλέον το όριο ως ⌈(N PPIDs × sub-products) / 2⌉ — το μισό κόστος των αντίστοιχων μεμονωμένων κλήσεων. Ένα αίτημα για 10 checkpoint με αμφότερα τα sub-products κοστίζει πλέον 10 units αντί για 20. Η κεφαλίδα X-Devapi-Units και το meta.units_consumed στην απόκριση αντικατοπτρίζουν το μειωμένο ποσό.

Ανακτήστε τη ζωντανή κατάσταση ουράς και τη φρεσκάδα δεδομένων για έως 20 checkpoint σε μία μόνο κλήση API — σχεδιασμένο για κατασκευαστές dashboard που αυτή τη στιγμή κάνουν polling πολλά PPID σε βρόχο.

Το όριο μετράται δίκαια ως N PPIDs × sub-products που ζητούνται, επομένως η συνολική χρήση είναι ταυτόσημη με τις μεμονωμένες κλήσεις — αλλά με μία μετάβαση μετ' επιστροφής αντί για πολλές. Τα μοτίβα τύπου GreenTravel μειώνονται από 24+ κλήσεις/ώρα σε 2.

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

• include=queue — τρέχον queue_now, εκτιμώμενο wait_min, ηλικία δεδομένων και όνομα checkpoint
• include=update-info — φρεσκάδα δεδομένων, ταξινόμηση πηγής, ηλικία σε δευτερόλεπτα/λεπτά
• Έως 20 PPID ανά αίτημα· συνδυάστε αμφότερα τα sub-products σε μία κλήση για πλήρη δεδομένα dashboard
• Η απόκριση περιλαμβάνει το meta.units_consumed, ώστε να παρακολουθείτε με ακρίβεια τη χρήση του ορίου

Η απόκριση του προϊόντος queue περιλαμβάνει πλέον ένα αντικείμενο snapshot ανώτατου επιπέδου με τα πιο πρόσφατα δεδομένα σε πραγματικό χρόνο και έναν υπολογισμένο προβλεπόμενο χρόνο αναμονής — τον ίδιο τύπο που χρησιμοποιείται στην ενότητα hero του 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

Ο πίνακας data (ιστορικές καταχωρίσεις) παραμένει αμετάβλητος — πρόκειται για καθαρά προσθετική προσθήκη. Οι clients που δεν διαβάζουν το snapshot δεν επηρεάζονται.

Υποβάλετε ερώτημα για όλα τα checkpoint σε ένα δεδομένο σύνορο + τύπο οχήματος σε μία κλήση, αντί να κάνετε ένα αίτημα ανά PPID.

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

• Υποστηρίζει μία χώρα προορισμού, μια λίστα χωρισμένη με κόμμα ή all για επέκταση σε κάθε παρακολουθούμενο γείτονα ταυτόχρονα.
• Τα αποτελέσματα ταξινομούνται κατά queue_now αύξουσα (η μικρότερη ουρά πρώτη).
• Πλήρως τοπικοποιημένο: προσθέστε ?lang=uk (ή οποιαδήποτε από τις 22 υποστηριζόμενες γλώσσες) για να λάβετε τα ονόματα των checkpoint σε αυτήν τη γλώσσα.

Ανακαλύψτε τις τιμές PPID των checkpoint κατά όνομα, χωρίς να περιηγηθείτε στον πλήρη κατάλογο.

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

• Δέχεται ένα μόνο όνομα ή μια λίστα χωρισμένη με κόμμα (έως 20).
• Αναζητά και στις 24 γλώσσες μετάφρασης — δώστε ένα όνομα στα ουκρανικά, πολωνικά, γερμανικά ή σε οποιαδήποτε υποστηριζόμενη γλώσσα και θα το εντοπίσει.
• Επιστρέφει όλα τα PPID σε αυτήν την τοποθεσία ομαδοποιημένα κατά τύπο οχήματος (αυτοκίνητο / λεωφορείο / πεζός / φορτηγό).

Το προϊόν alternatives δέχεται πλέον ?lang= και στις 22 υποστηριζόμενες γλώσσες (προηγουμένως μόνο 12).

Η νέα παράμετρος crossing_type σάς επιτρέπει να παρακάμψετε το φίλτρο τύπου οχήματος — π.χ. δώστε crossing_type=4 για να λάβετε εναλλακτικές για αυτοκίνητα ακόμη και όταν υποβάλλετε ερώτημα από PPID λεωφορείου.

Το πεδίο crossing_type_label στις αποκρίσεις των checkpoints, border και search μεταφράζεται πλέον στη ζητούμενη γλώσσα και στις 22 υποστηριζόμενες γλώσσες. Τα πεδία ονόματος χώρας (origin_name, destination_name) ακολουθούν την ίδια τοπική ρύθμιση.

Η πύλη Nakordoni Developer API είναι ενεργή στο /en/developers. Εγγραφείτε για ένα δωρεάν κλειδί Explorer (200 αιτήματα/ημέρα) για πρόσβαση σε δεδομένα ουρών συνόρων, προβλέψεις, τιμές καυσίμων, POI οδηγών και άλλα.

Διαθέσιμα προϊόντα κατά την κυκλοφορία: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.