API-Dokumentation

Authentifizierung

Jede Anfrage benötigt Ihren API-Schlüssel im Authorization-Header (empfohlen) oder als Parameter ?key=.

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

Antwortformat

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

Fehler geben ok:false mit error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) und HTTP-Status 401/403/404/429/500 zurück. Die Ratenbegrenzungs-Header X-Devapi-Limit und X-Devapi-Remaining werden bei jeder abgerechneten Antwort gesendet.

Kontingente

Tägliche Zähler werden um Mitternacht UTC zurückgesetzt. Sie erhalten eine E-Mail bei 80 % und 100 % des Kontingents.

Codebeispiele

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"])

Produkte

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

Standard nutzt das Standard-Datenkontingent  ·  Schwer nutzt das Kontingent für Prognosen und Statistiken — siehe Kontingente

Grenzwarteschlangen

Prognosen & Statistiken

Kraftstoff & Standorte

Reiseplanung

Fahrer & Straßen

KI-Assistent

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

Was Sie bauen können

Dieselben Datenprodukte rendern die Visualisierungen auf nakordoni.eu — wöchentliche Prognosediagramme, stündliche Warteschlangenprofile, Live-Statuskarten. Ein Vorgeschmack darauf, was die Prognose- und Statistik-APIs enthalten:

Attribution

Integrationen im Explorer-Plan müssen einen sichtbaren Link "Data by nakordoni.eu" überall dort anzeigen, wo die Daten dargestellt werden. Das hält den kostenlosen Plan kostenlos.

Der genaue Code

Kopieren Sie dieses Snippet unverändert. Der Link muss indexierbar bleiben: ein einfaches HTML <a href>, dem Suchmaschinen folgen können — KEIN rel="nofollow" oder rel="sponsored" hinzufügen, nicht nur per JavaScript rendern und nicht per CSS verstecken.

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

Kompakte Kleingedruckt-Variante (z. B. unter einem Diagramm oder Widget):

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

Sie können stattdessen auf Ihre Sprachversion verlinken, z. B. https://nakordoni.eu/de/ — jeder indexierbare Link auf nakordoni.eu zählt. Der Ankertext "Data by nakordoni.eu" muss englisch bleiben.

Wo platzieren

• Direkt neben oder unter dem Datenblock (Tabelle, Diagramm, Widget, Antwort) — auf demselben Bildschirm, sichtbar ohne zusätzliche Klicks.
• Auf jeder Seite bzw. jedem App-Screen, wo unsere Daten erscheinen — nicht nur auf einer "Über uns"-Seite.
• Lesbare Größe und Kontrast: mindestens ~11px, nicht versteckt, nicht eingeklappt, nicht in Hintergrundfarbe.
• Native Mobile-Apps ohne HTML-Links: Text "Data by nakordoni.eu" auf dem Datenbildschirm anzeigen und den antippbaren Link auf dem Info-Screen platzieren.

Wir prüfen die Attribution regelmäßig auf der bei der Registrierung angegebenen "Seite der Datennutzung". Fehlende oder deindexierte Attribution im Explorer-Plan führt zuerst zu einer Erinnerung, dann zur Schlüsselsperrung. Pay-As-You-Grow-Kunden können die Attribution weglassen.

Kostenlosen API-Schlüssel erhalten