Τεκμηρίωση του 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"])

Προϊόντα

Pick an endpoint for its full reference, parameters, versions and a live sandbox.

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

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

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

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

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

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

Βοηθός ΤΝ

Other

History data export

Approved developers can download hourly-averaged, published border-queue history for up to 5 checkpoints (rolling window up to 90 days) as gzipped CSV, NDJSON, or JSON. This is a portal-only feature — NOT an API endpoint; you build and download exports from the "Data export" tab in your account.

Access is granted on request: open a Data ticket telling us which checkpoints, the time window, and your intended use. Once approved, the Data export tab appears in your account. Default limit: 1 export/day, up to 5 checkpoints each — ask us to raise it.

Fields — one row per checkpoint per UTC hour

Data is published-only and passes our anomaly / data-quality checks before export (no raw per-report data). All timestamps are UTC. Files are kept for 10 days.

Provenance: every file embeds a signed fingerprint (sha256 + HMAC) in its header, so any copy can later be confirmed as genuine nakordoni.eu data and checked for tampering — even after download.

# 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 σας