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.

Kostenpflichtige Tarife heben jedes dieser Limits an. Aktuelle Tarife und ihre Kontingente: Pläne

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

Excel (Power Query)

Holen Sie Live-Warteschlangen-, Prognose- oder LKW-Fahrverbotsdaten mit dem integrierten JSON-Connector von Power Query direkt in eine Arbeitsmappe — ohne Code, planmäßig aktualisierbar. Dasselbe Headers-Muster funktioniert für jedes Produkt dieser API — nur die URL ändern.

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

Bewahren Sie den API-Schlüssel innerhalb der M-Abfrage auf (Home → Advanced Editor), nicht in einer Arbeitsblattzelle — Power Query blockiert eine Webanfrage, die aus einer anderen Abfrage oder Zelle aufgebaut wird ("Formula.Firewall"), sofern die Datenschutzstufe nicht auf Organizational gesetzt ist.

Mehrere Grenzübergänge in einer Tabelle (Flotten-Dashboards) — 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 in Excel oder eine geplante Aktualisierung in Power BI / Excel Online hält die Zahlen aktuell — ohne Polling-Code.

ERP-Integration (BAS / BAF und Plattformen der 1C-Familie)

BAS / BAF und andere Plattformen der 1C-Familie können diese API direkt aus einem geplanten Auftrag heraus aufrufen — HTTPConnection plus ReadJSON, ohne Zwischenschicht und ohne zusätzlichen Dienst. Der häufigste Aufbau hält ein Informationsregister mit EU-Kraftstoffpreisen aktuell.

Ein Informationsregister aktualisieren (Kraftstoffpreise, alle Länder in einem Aufruf)

// 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;

Drei Dinge müssen stimmen: New OpenSSLSecureConnection auf Port 443 übergeben, sonst scheitert die Anfrage an TLS; /api/v1/data/fuel ohne country-Parameter aufrufen, damit eine Anfrage alle Länder liefert statt eines Aufrufs pro Land; und ok prüfen, bevor Sie data anfassen — Fehler kommen als ok:false mit error.code zurück, nicht als Ausnahme. Das Beispiel nutzt den englischen Schlüsselwortsatz der Plattform; die lokalisierten Entsprechungen (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) verhalten sich identisch.

Kraftstoffpreise ändern sich an der Quelle einmal täglich, ein geplanter Auftrag ein- oder zweimal am Tag genügt also und bleibt weit innerhalb des kostenlosen Explorer-Kontingents. Live-Wartedaten (queue, multi, border) ändern sich alle paar Minuten — fragen Sie diese nach eigenem Takt ab und lesen Sie mit multi bis zu 5 Grenzübergänge in einer einzigen Anfrage statt in einer Schleife.

MCP-Server

Bevorzugen Sie Tool-Aufrufe statt REST? Wir betreiben einen echten MCP-Server (Streamable-HTTP-Transport), der eine sichere, schreibgeschützte Teilmenge dieser API als MCP-Tools bereitstellt — derselbe API-Schlüssel, dasselbe Kontingent, nur ein anderer Transport.

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

Client-Konfiguration (Claude Desktop / Claude Code):

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

Produkte

Wählen Sie einen Endpunkt für die vollständige Referenz, Parameter, Versionen und eine 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

Your Fleet (NakBus Live)

KI-Assistent

Export historischer Daten

Freigegebene Entwickler können die veröffentlichte, stündlich gemittelte Historie der Grenzwarteschlangen für bis zu 5 Grenzübergänge (rollierendes Fenster bis 90 Tage) als gzip-komprimiertes CSV, NDJSON oder JSON herunterladen. Das ist eine reine Portalfunktion — KEIN API-Endpunkt; Sie erstellen und laden Exporte im Tab „Datenexport“ in Ihrem Konto.

Der Zugang wird auf Anfrage gewährt: Öffnen Sie ein Data-Ticket und nennen Sie uns die Grenzübergänge, den Zeitraum und den geplanten Verwendungszweck. Nach der Freigabe erscheint der Tab „Datenexport“ in Ihrem Konto. Standardlimit: 1 Export/Tag mit je bis zu 5 Grenzübergängen — bitten Sie uns um eine Anhebung.

Felder — eine Zeile pro Grenzübergang und UTC-Stunde

Exportiert werden ausschließlich veröffentlichte Daten, die zuvor unsere Anomalie- und Datenqualitätsprüfungen durchlaufen haben (keine Rohdaten einzelner Meldungen). Alle Zeitstempel sind UTC. Dateien werden 10 Tage aufbewahrt.

Herkunft: Jede Datei enthält im Header einen signierten Fingerabdruck (sha256 + HMAC), sodass jede Kopie später als echte nakordoni.eu-Daten bestätigt und auf Manipulation geprüft werden kann — auch nach dem 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 kostenlosen Explorer-Plan führt zuerst zu einer Erinnerung, dann zur Schlüsselsperrung. Kunden mit einem kostenpflichtigen Plan können die Attribution weglassen.

Datenlizenz und Märkte

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.
• Wir können nur einige der von Ihnen angeforderten Länder genehmigen. Die genehmigte Liste – nicht die angeforderte – definiert, welche Länder Ihre Lizenz abdeckt.
• 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.

Datenaktualität

Wie aktuell Ihre Daten sind, hängt von Ihrem Tarif ab. In der Antwort selbst gibt es keine Kennzeichnung — jeder Tarif liefert dieselben Felder, dieselben Typen und dieselbe Antwortstruktur.

• Bezahltarife — Student, Starter, Pro und Pro MAX: Live-Telemetrie, ohne Verzögerung.
• Kostenloser Explorer-Tarif: eine Momentaufnahme der letzten 15 bis 30 Minuten. Der genaue Versatz ist von Anfrage zu Anfrage unterschiedlich.

Eine verzögerte Antwort ist niemals ein Fehler und niemals ein Kontingentproblem — sie ist eine vollständige, gültige Antwort mit älteren Zahlen. Ein erneuter Aufruf liefert keine neueren Daten.

Wenn Ihre Anwendung aktuelle Daten benötigt, liefert jeder Bezahltarif Echtzeit-Telemetrie.

Kostenlosen API-Schlüssel erhalten