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

REST + JSON μέσω HTTPS. Ένα βασικό URL, ένα κλειδί, προβλέψιμα envelopes.

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

Κάθε αίτημα χρειάζεται το κλειδί 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, usage } = await res.json();
if (!ok) throw new Error(data?.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"])

Προϊόντα

Checkpoints Directory API

Directory of all monitored border checkpoints: IDs, names, countries, coordinates and status. Use it to discover ppid values for the other APIs.

GET https://nakordoni.eu/api/v1/data/checkpoints — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/checkpoints" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Live Border Queue API

Real-time queue length, wait estimate and status for any monitored checkpoint, plus hourly/daily aggregates.

GET https://nakordoni.eu/api/v1/data/queue — κλάση ποσόστωσης: heavy

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

Checkpoint Hourly Statistics API

Hourly historical queue stats per checkpoint and date: 24 hourly values, daily avg/min/max, peak and quietest hours, day-over-day comparison.

GET https://nakordoni.eu/api/v1/data/stats — κλάση ποσόστωσης: heavy

curl "https://nakordoni.eu/api/v1/data/stats?ppid=id_15&date=2026-06-01&compare=1" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Queue Forecast API

ML ensemble forecast of queue levels: 24-hour and 7-day (168h) horizons with confidence bounds. The same model that powers nakordoni.eu predictions.

GET https://nakordoni.eu/api/v1/data/forecast — κλάση ποσόστωσης: heavy

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

Checkpoint Alternatives API

Nearby alternative checkpoints on the same border with current queues and distance deltas.

GET https://nakordoni.eu/api/v1/data/alternatives — κλάση ποσόστωσης: cheap

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

Data Freshness API

When a checkpoint was last updated, by which source, and a freshness rating.

GET https://nakordoni.eu/api/v1/data/update-info — κλάση ποσόστωσης: cheap

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

EU Fuel Prices API

Average petrol/diesel/LPG prices across EU countries plus nearest stations, aggregated from official national sources.

GET https://nakordoni.eu/api/v1/data/fuel — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Driver POIs API

Truck parkings (14k+), free showers, services and supermarkets across Europe with coordinates.

GET https://nakordoni.eu/api/v1/data/pois — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/pois?type=parking&lat=50.7&lon=23.9&radius=50" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Truck Driving Bans API

European truck driving restrictions by country and date, including seasonal and holiday bans.

GET https://nakordoni.eu/api/v1/data/truck-bans — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/truck-bans?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Trading Sundays API

Sunday retail-opening regulations and upcoming trading Sundays per regulated EU country.

GET https://nakordoni.eu/api/v1/data/trading-sundays — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/trading-sundays?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Border Weather API Σύντομα διαθέσιμο

Current conditions and road warnings at border checkpoints. (Coming soon)

GET https://nakordoni.eu/api/v1/data/weather — κλάση ποσόστωσης: cheap

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

Bus Carrier Border Stats API

Border-crossing performance per bus carrier: crossings, average/median/min/max wait minutes — built from our own plate-matched crossing records.

GET https://nakordoni.eu/api/v1/data/bus-carriers — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/bus-carriers?ppid=all&days=30" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Road Conditions API

Approved road condition reports near borders and on major corridors: potholes, roadworks, closures, ice, hazards — combining driver reports with automatic accelerometer detections from our navigation app.

GET https://nakordoni.eu/api/v1/data/road-conditions — κλάση ποσόστωσης: cheap

curl "https://nakordoni.eu/api/v1/data/road-conditions?country=UA&severity=major" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Border AI Assistant API

Ask our production AI assistant any border-crossing question (queues, forecasts, rules, fuel, routes) and get the same grounded answer that powers the nakordoni.eu widget — in 24 languages. Already used in production by yaknakordoni.com.ua.

GET https://nakordoni.eu/api/v1/data/assistant — κλάση ποσόστωσης: heavy

curl "https://nakordoni.eu/api/v1/data/assistant?q=How long is the queue at Krakovets now?&lang=en&ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Road Quality API Σύντομα διαθέσιμο

Road roughness scores per corridor computed from anonymized accelerometer telemetry of real drives: roughness index 0-100, pothole density per km, rough-corridor clusters with coordinates. (Coming soon)

GET https://nakordoni.eu/api/v1/data/road-quality — κλάση ποσόστωσης: heavy

curl "https://nakordoni.eu/api/v1/data/road-quality?bbox=22.5,48.2,24.5,50.5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

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

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

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

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

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