Τεκμηρίωση του API

Έλεγχος ταυτότητας

Κάθε αίτημα χρειάζεται το κλειδί API σας στην κεφαλίδα Authorization (συνιστάται) ή ως παράμετρο ?key=.

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Envelope απόκρισης

{
  "ok": true,
  "api_version": "v1",
  "product": "queue",
  "attribution": "Data by nakordoni.eu",
  "data": { ... },
  "usage": { "limit": 1000, "used": 42, "reset": "2026-06-06T00:00:00Z" }
}

Τα σφάλματα επιστρέφουν ok:false με error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) και κατάσταση HTTP 401/403/404/429/500. Οι κεφαλίδες ορίου ρυθμού X-Devapi-Limit και X-Devapi-Remaining αποστέλλονται σε κάθε μετρούμενη απόκριση.

Ποσοστώσεις

Οι ημερήσιοι μετρητές μηδενίζονται τα μεσάνυχτα UTC. Λαμβάνετε ένα email στο 80% και στο 100% της ποσόστωσης.

Τα συνδρομητικά προγράμματα ανεβάζουν κάθε ένα από αυτά τα όρια. Τρέχοντα προγράμματα και τα όριά τους: Προγράμματα

Δείγματα κώδικα

curl

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer $NKD_API_KEY"

JavaScript (fetch)

const res = await fetch('https://nakordoni.eu/api/v1/data/forecast?ppid=id_13&prediction_steps=24', {
  headers: { Authorization: `Bearer ${process.env.NKD_API_KEY}` }
});
const { ok, data, error, usage } = await res.json();
if (!ok) throw new Error(error?.code ?? res.status);
console.log(`forecast points: ${data.length}, calls left today: ${usage.limit - usage.used}`);

Python (requests)

import os, requests

r = requests.get(
    "https://nakordoni.eu/api/v1/data/stats",
    params={"ppid": "id_15", "compare": 1},
    headers={"Authorization": f"Bearer {os.environ['NKD_API_KEY']}"},
    timeout=15,
)
payload = r.json()
print(payload["data"]["daily"], payload["usage"])

Excel (Power Query)

Αντλήστε δεδομένα ουρών, προβλέψεων ή απαγορεύσεων φορτηγών ζωντανά σε ένα βιβλίο εργασίας με τον ενσωματωμένο σύνδεσμο JSON του Power Query — χωρίς κώδικα, με προγραμματισμένη ανανέωση. Το ίδιο μοτίβο Headers λειτουργεί για κάθε προϊόν αυτού του API — αρκεί να αλλάξετε το URL.

Data → Get Data → From Other Sources → Blank Query, then Home → Advanced Editor and paste:

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/queue",
        [Query = [ppid = "id_13"], Headers = [Authorization = "Bearer " & ApiKey]])),
    data = Source[data],
    AsTable = Record.ToTable(data)
in
    AsTable

Κρατήστε το κλειδί API μέσα στο ερώτημα M (Home → Advanced Editor), όχι σε ένα κελί φύλλου — το Power Query μπλοκάρει ένα αίτημα ιστού που έχει δημιουργηθεί από άλλο ερώτημα ή κελί ("Formula.Firewall"), εκτός αν το επίπεδο απορρήτου έχει οριστεί σε Organizational.

Πολλά συνοριακά σημεία σε έναν πίνακα (πίνακες ελέγχου στόλου) — e.g. every truck crossing UA→EU (crossing_type=9):

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/border/1/all/9",
        [Headers = [Authorization = "Bearer " & ApiKey]])),
    checkpoints = Source[data],
    AsTable = Table.FromRecords(checkpoints)
in
    AsTable

Το Data → Refresh All στο Excel, ή μια προγραμματισμένη ανανέωση στο Power BI / Excel Online, διατηρεί τα δεδομένα ενημερωμένα — χωρίς κώδικα polling.

Ενσωμάτωση ERP (BAS / BAF και πλατφόρμες της οικογένειας 1C)

Το BAS / BAF και οι άλλες πλατφόρμες της οικογένειας 1C μπορούν να καλέσουν αυτό το API απευθείας από μια προγραμματισμένη εργασία — HTTPConnection και ReadJSON, χωρίς ενδιάμεσο λογισμικό ή επιπλέον υπηρεσία. Η πιο συνηθισμένη χρήση κρατά ενημερωμένο ένα μητρώο πληροφοριών με τις τιμές καυσίμων στην ΕΕ.

Ενημέρωση μητρώου πληροφοριών (τιμές καυσίμων, όλες οι χώρες σε μία κλήση)

// Scheduled job — runs once a day
Connection = New HTTPConnection("nakordoni.eu", 443, , , , 30, New OpenSSLSecureConnection);

Headers = New Map;
Headers.Insert("Authorization", "Bearer NKD-DEV-XXXX-XXXX-XXXX");

Request  = New HTTPRequest("/api/v1/data/fuel", Headers);
Response = Connection.Get(Request);

Reader = New JSONReader;
Reader.SetString(Response.GetBodyAsString("UTF-8"));
Answer = ReadJSON(Reader, True);
Reader.Close();

If Answer["ok"] <> True Then
    // Answer["error"]["code"] says why; Answer["usage"] holds your quota state
    Return;
EndIf;

For Each Row In Answer["data"] Do
    Record = InformationRegisters.FuelPrices.CreateRecordManager();
    Record.Period   = CurrentSessionDate();
    Record.Country  = Row["country"];    // "PL", "DE", "SK", "RO", ...
    Record.Diesel   = Row["diesel"];
    Record.Petrol   = Row["petrol"];
    Record.LPG      = Row["lpg"];
    Record.Currency = Row["currency"];
    Record.Write();
EndDo;

Τρία σημεία που πρέπει να πετύχετε: περάστε New OpenSSLSecureConnection στη θύρα 443, αλλιώς το αίτημα σκάει στο TLS· καλέστε το /api/v1/data/fuel χωρίς την παράμετρο country, ώστε ένα αίτημα να επιστρέψει όλες τις χώρες αντί για μία κλήση ανά χώρα· και ελέγξτε το ok πριν αγγίξετε το data — τα σφάλματα επιστρέφουν ως ok:false με error.code, όχι ως εξαίρεση. Το παράδειγμα χρησιμοποιεί το αγγλικό σύνολο λέξεων-κλειδιών της πλατφόρμας· τα τοπικοποιημένα αντίστοιχα (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) συμπεριφέρονται ίδια.

Οι τιμές καυσίμων αλλάζουν στην πηγή μία φορά την ημέρα, οπότε μια προγραμματισμένη εργασία μία ή δύο φορές την ημέρα αρκεί και μένει πολύ μέσα στο δωρεάν όριο Explorer. Τα ζωντανά δεδομένα ουρών (queue, multi, border) αλλάζουν κάθε λίγα λεπτά — ρωτήστε τα με δικό σας ρυθμό και χρησιμοποιήστε το multi για να διαβάσετε έως 5 συνοριακά σημεία σε ένα αίτημα αντί για βρόχο.

Διακομιστής MCP

Προτιμάτε την κλήση εργαλείων αντί για REST; Λειτουργούμε έναν πραγματικό διακομιστή MCP (μεταφορά Streamable HTTP) που εκθέτει ένα ασφαλές, μόνο για ανάγνωση υποσύνολο αυτού του API ως εργαλεία MCP — το ίδιο κλειδί API, η ίδια ποσόστωση, απλώς διαφορετική μεταφορά.

Endpoint: https://nakordoni.eu/mcp · Server card: /.well-known/mcp/server-card.json

get_api_status      — no key required
list_checkpoints     — country, lang
get_border_queue     — origin, destination, crossing_type, lang
get_live_queue       — ppid, lang
get_queue_forecast   — ppid, prediction_steps

Διαμόρφωση πελάτη (Claude Desktop / Claude Code):

{
  "mcpServers": {
    "nakordoni": {
      "url": "https://nakordoni.eu/mcp",
      "headers": { "Authorization": "Bearer NKD-DEV-XXXX-XXXX-XXXX" }
    }
  }
}

Προϊόντα

Επιλέξτε ένα endpoint για την πλήρη αναφορά του, τις παραμέτρους, τις εκδόσεις και ένα ζωντανό Sandbox.

Πρότυπος αντλεί από το πρότυπο όριο δεδομένων  ·  Βαρύ αντλεί από το πιστωτικό όριο προβλέψεων και στατιστικών — βλέπε Ποσοστώσεις

Ουρές στα σύνορα

Προβλέψεις και Στατιστικές

Καύσιμα και Τοποθεσίες

Σχεδιασμός Ταξιδιού

Οδηγοί και Δρόμοι

Your Fleet (NakBus Live)

Βοηθός ΤΝ

Εξαγωγή ιστορικών δεδομένων

Οι εγκεκριμένοι προγραμματιστές μπορούν να κατεβάσουν το δημοσιευμένο ιστορικό των συνοριακών ουρών, με ωριαίο μέσο όρο, για έως 5 συνοριακά σημεία (κυλιόμενο παράθυρο έως 90 ημερών) ως συμπιεσμένο gzip CSV, NDJSON ή JSON. Πρόκειται για λειτουργία μόνο της πύλης — ΟΧΙ για endpoint του API· τις εξαγωγές τις δημιουργείτε και τις κατεβάζετε από την καρτέλα «Εξαγωγή δεδομένων» στον λογαριασμό σας.

Η πρόσβαση παρέχεται κατόπιν αιτήματος: ανοίξτε ένα αίτημα υποστήριξης τύπου Data λέγοντάς μας ποια συνοριακά σημεία, το χρονικό διάστημα και τη σκοπούμενη χρήση. Μετά την έγκριση, η καρτέλα «Εξαγωγή δεδομένων» εμφανίζεται στον λογαριασμό σας. Προεπιλεγμένο όριο: 1 εξαγωγή/ημέρα, έως 5 σημεία η καθεμία — ζητήστε μας να το αυξήσουμε.

Πεδία — μία γραμμή ανά συνοριακό σημείο ανά ώρα UTC

Εξάγονται μόνο δημοσιευμένα δεδομένα, τα οποία περνούν τους ελέγχους ανωμαλιών και ποιότητας πριν από την εξαγωγή (χωρίς ακατέργαστες μεμονωμένες αναφορές). Όλες οι χρονοσημάνσεις είναι σε UTC. Τα αρχεία διατηρούνται για 10 ημέρες.

Προέλευση: κάθε αρχείο ενσωματώνει στην κεφαλίδα του ένα υπογεγραμμένο αποτύπωμα (sha256 + HMAC), ώστε οποιοδήποτε αντίγραφο να μπορεί αργότερα να επιβεβαιωθεί ως γνήσια δεδομένα του nakordoni.eu και να ελεγχθεί για αλλοιώσεις — ακόμη και μετά τη λήψη.

# sha256: 3f9c…   # signature: e87b…
ppid,checkpoint_name,hour_utc,direction,vehicle_type,avg_queue_length,avg_wait_minutes,sample_count
id_10,Hrushiv,2026-06-12T02:00:00Z,UA->PL,car,11,,4

Τι μπορείτε να δημιουργήσετε

Τα ίδια προϊόντα δεδομένων αποδίδουν τα γραφικά στο nakordoni.eu — εβδομαδιαία γραφήματα πρόβλεψης, ωριαία προφίλ ουρών, κάρτες κατάστασης σε πραγματικό χρόνο. Μια γεύση από το τι περιέχουν τα API προβλέψεων και στατιστικών:

Απόδοση πηγής

Οι ενσωματώσεις του προγράμματος Explorer πρέπει να εμφανίζουν έναν ορατό σύνδεσμο "Data by nakordoni.eu" όπου εμφανίζονται τα δεδομένα. Αυτό κρατά δωρεάν το δωρεάν πρόγραμμα.

Ο ακριβής κώδικας

Αντιγράψτε αυτό το απόσπασμα ως έχει. Ο σύνδεσμος πρέπει να παραμείνει ευρετηριάσιμος: ένα απλό HTML <a href> που μπορούν να ακολουθήσουν οι μηχανές αναζήτησης — ΜΗΝ προσθέτετε rel="nofollow" ή rel="sponsored", μην τον αποδίδετε μόνο μέσω JavaScript και μην τον κρύβετε με CSS.

<a href="https://nakordoni.eu/" title="Border queues, forecasts &amp; statistics">Data by nakordoni.eu</a>

Συμπαγής παραλλαγή με μικρά γράμματα (π.χ. κάτω από γράφημα ή widget):

<p style="font-size:12px;margin:4px 0">
  Data by <a href="https://nakordoni.eu/">nakordoni.eu</a>
</p>

Μπορείτε να συνδέσετε τη γλωσσική σας έκδοση, π.χ. https://nakordoni.eu/el/ — μετράει κάθε ευρετηριάσιμος σύνδεσμος προς το nakordoni.eu. Το κείμενο αγκύρωσης "Data by nakordoni.eu" πρέπει να μείνει στα αγγλικά.

Πού να τοποθετηθεί

• Ακριβώς δίπλα ή κάτω από το μπλοκ δεδομένων (πίνακας, γράφημα, widget, απάντηση) — στην ίδια οθόνη, ορατό χωρίς επιπλέον κλικ.
• Σε κάθε σελίδα ή οθόνη εφαρμογής όπου εμφανίζονται τα δεδομένα μας — όχι μόνο σε μια σελίδα "σχετικά".
• Ευανάγνωστο μέγεθος και αντίθεση: τουλάχιστον ~11px, όχι κρυμμένο, όχι συμπτυγμένο, όχι στο χρώμα του φόντου.
• Εγγενείς εφαρμογές κινητών χωρίς HTML συνδέσμους: εμφανίστε το κείμενο "Data by nakordoni.eu" στην οθόνη δεδομένων και βάλτε τον σύνδεσμο στην οθόνη πληροφοριών.

Ελέγχουμε περιοδικά την απόδοση στη "σελίδα χρήσης δεδομένων" που δηλώσατε στην εγγραφή. Ελλιπής ή αποευρετηριασμένη απόδοση στο δωρεάν πλάνο Explorer οδηγεί πρώτα σε υπενθύμιση, μετά σε αναστολή κλειδιού. Οι πελάτες με επί πληρωμή πρόγραμμα μπορούν να την παραλείψουν.

Άδεια δεδομένων και αγορές

Your API key grants a licence to use our data in the countries you declared when you signed up, and only in those countries. We review every declaration before granting full access, because our data is our own product and we do not license it into markets without knowing where it will be published.

• Declare every country your site, app or product serves. You can change the list from your dashboard at any time; a change puts your account back into review.
• Until your markets are approved your key runs on reduced limits - half of the Starter plan allowance. This applies whatever plan you are on.
• Ενδέχεται να εγκρίνουμε μόνο ορισμένες από τις χώρες που ζητήσατε. Η εγκεκριμένη λίστα, όχι αυτή που ζητήσατε, καθορίζει τις χώρες που καλύπτει η άδεια σας.
• Publishing or redistributing our data in a market you did not declare, or reselling it as a competing data feed, is a breach of these terms and can suspend your key without notice.
• Some plans are offered only in selected regions. Availability depends on the markets you declare.

Ενημερότητα δεδομένων

Το πόσο πρόσφατα είναι τα δεδομένα σας εξαρτάται από το πρόγραμμά σας. Στην ίδια την απόκριση δεν υπάρχει καμία ένδειξη — όλα τα προγράμματα επιστρέφουν τα ίδια πεδία, τους ίδιους τύπους και την ίδια δομή απόκρισης.

• Προγράμματα επί πληρωμή — Student, Starter, Pro και Pro MAX: ζωντανή τηλεμετρία, χωρίς καθυστέρηση.
• Δωρεάν πρόγραμμα Explorer: στιγμιότυπο από τα τελευταία 15 έως 30 λεπτά. Η ακριβής απόκλιση διαφέρει από αίτημα σε αίτημα.

Μια καθυστερημένη απόκριση δεν είναι ποτέ σφάλμα ούτε πρόβλημα ορίου — είναι μια πλήρης, έγκυρη απόκριση με παλαιότερους αριθμούς. Η επανάληψη του αιτήματος δεν επιστρέφει νεότερα δεδομένα.

Αν η εφαρμογή σας χρειάζεται τρέχοντα δεδομένα, οποιοδήποτε πρόγραμμα επί πληρωμή επιστρέφει τηλεμετρία σε πραγματικό χρόνο.

Αποκτήστε το δωρεάν κλειδί API σας