Τεκμηρίωση του 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 για να διαβάσετε έως 20 συνοριακά σημεία σε ένα αίτημα αντί για βρόχο.

Διακομιστής 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.

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

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

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

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

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

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

Βοηθός ΤΝ

Άλλα

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

Οι εγκεκριμένοι προγραμματιστές μπορούν να κατεβάσουν το δημοσιευμένο ιστορικό των συνοριακών ουρών, με ωριαίο μέσο όρο, για έως 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 οδηγεί πρώτα σε υπενθύμιση, μετά σε αναστολή κλειδιού. Οι πελάτες Pay As You Grow μπορούν να την παραλείψουν.

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