Dokumentácia API

Autentifikácia

Každá požiadavka potrebuje váš API kľúč v hlavičke Authorization (odporúčané) alebo ako parameter ?key=.

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

Obálka odpovede

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

Chyby vracajú ok:false s error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) a HTTP stavom 401/403/404/429/500. Hlavičky obmedzenia rýchlosti X-Devapi-Limit a X-Devapi-Remaining sa odosielajú pri každej meranej odpovedi.

Kvóty

Denné počítadlá sa resetujú o polnoci UTC. E-mail dostanete pri 80 % a 100 % kvóty.

Platené plány zvyšujú každý z týchto limitov. Aktuálne plány a ich limity: Plány

Ukážky kódu

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)

Získajte živé údaje o frontách, predpovediach či zákazoch pre nákladné vozidlá priamo do zošita pomocou vstavaného JSON konektora Power Query — bez kódu, s obnovou podľa plánu. Rovnaký vzor Headers funguje pre každý produkt tohto API — stačí zmeniť 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

Kľúč API uchovávajte vnútri M-dotazu (Home → Advanced Editor), nie v bunke hárka — Power Query blokuje webovú požiadavku zostavenú z iného dotazu alebo bunky ("Formula.Firewall"), pokiaľ nie je úroveň ochrany súkromia nastavená na Organizational.

Viacero hraničných priechodov v jednej tabuľke (flotilové dashboardy) — 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 v Exceli alebo naplánovaná obnova v Power BI / Excel Online udržiava čísla aktuálne — bez kódu na dopytovanie (polling).

Integrácia s ERP (BAS / BAF a platformy rodiny 1C)

BAS / BAF a ďalšie platformy rodiny 1C môžu volať toto API priamo z naplánovanej úlohy — HTTPConnection plus ReadJSON, bez medzivrstvy a bez ďalšej služby. Najčastejšie nasadenie udržiava aktuálny register informácií s cenami palív v EÚ.

Aktualizácia registra informácií (ceny palív, všetky krajiny jedným volaním)

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

Tri veci treba trafiť: odovzdajte New OpenSSLSecureConnection na porte 443, inak požiadavka padne na TLS; volajte /api/v1/data/fuel bez parametra country, aby jedna požiadavka vrátila všetky krajiny namiesto volania na každú zvlášť; a overte ok skôr, než siahnete na data — chyby prichádzajú ako ok:false s error.code, nie ako výnimka. Ukážka používa anglickú sadu kľúčových slov platformy; lokalizované ekvivalenty (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) sa správajú rovnako.

Ceny palív sa v zdrojoch menia raz denne, takže naplánovaná úloha raz či dvakrát denne stačí a zostáva hlboko v bezplatnej kvóte Explorer. Živé údaje o radoch (queue, multi, border) sa menia každých pár minút — tie sťahujte vlastným tempom a pomocou multi načítajte až 5 hraničných priechodov jednou požiadavkou namiesto cyklu.

MCP server

Uprednostňujete volanie nástrojov pred REST? Prevádzkujeme skutočný MCP server (prenos Streamable HTTP), ktorý sprístupňuje bezpečnú, len na čítanie určenú podmnožinu tohto API ako MCP nástroje — rovnaký API kľúč, rovnaká kvóta, len iný prenos.

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

Konfigurácia klienta (Claude Desktop / Claude Code):

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

Produkty

Vyberte si endpoint pre jeho úplnú referenciu, parametre, verzie a živý sandbox.

Štandardný využíva štandardnú dátovú kvótu  ·  Ťažký využíva kvótu prognóz a štatistík — pozri Kvóty

Fronty na hranici

Predpovede a štatistiky

Palivo a lokality

Cestovné plánovanie

Vodiči a cesty

Your Fleet (NakBus Live)

AI asistent

Export historických údajov

Schválení vývojári si môžu stiahnuť zverejnenú históriu hraničných radov spriemerovanú po hodinách pre najviac 5 priechodov (posuvné okno až 90 dní) ako gzipovaný CSV, NDJSON alebo JSON. Je to funkcia dostupná len v portáli — NIE endpoint API; exporty si zostavujete a sťahujete v záložke „Export údajov“ vo svojom účte.

Prístup udeľujeme na požiadanie: otvorte tiket Údaje a napíšte nám, ktoré priechody, aké časové okno a na aký účel. Po schválení sa vo vašom účte objaví záložka Export údajov. Predvolený limit: 1 export/deň, každý najviac 5 priechodov — požiadajte nás o navýšenie.

Polia — jeden riadok na priechod a UTC hodinu

Exportujú sa len zverejnené údaje, ktoré prejdú našimi kontrolami anomálií a kvality (žiadne surové údaje z jednotlivých hlásení). Všetky časové značky sú v UTC. Súbory uchovávame 10 dní.

Pôvod: každý súbor má v hlavičke vložený podpísaný odtlačok (sha256 + HMAC), takže o ľubovoľnej kópii sa dá neskôr potvrdiť, že ide o pravé údaje nakordoni.eu, a overiť, či nebola pozmenená — aj po stiahnutí.

# 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

Čo môžete vytvoriť

Tie isté dátové produkty vykresľujú vizuály na nakordoni.eu — grafy týždenných predpovedí, hodinové profily radov, živé stavové karty. Ukážka toho, čo obsahujú API predpovedí a štatistík:

Uvedenie zdroja

Integrácie plánu Explorer musia zobrazovať viditeľný odkaz „Data by nakordoni.eu“ všade, kde sa údaje zobrazujú. Vďaka tomu zostáva bezplatný plán bezplatný.

Presný kód

Skopírujte tento úryvok bez zmien. Odkaz musí zostať indexovateľný: obyčajný HTML <a href>, ktorý môžu vyhľadávače nasledovať — NEPRIDÁVAJTE rel="nofollow" ani rel="sponsored", nevykresľujte ho len cez JavaScript a neskrývajte cez CSS.

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

Kompaktný drobný variant (napr. pod grafom alebo widgetom):

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

Môžete odkazovať na svoju jazykovú verziu, napr. https://nakordoni.eu/sk/ — počíta sa každý indexovateľný odkaz na nakordoni.eu. Text kotvy "Data by nakordoni.eu" musí zostať v angličtine.

Kde umiestniť

• Priamo vedľa alebo pod blokom dát (tabuľka, graf, widget, odpoveď) — na rovnakej obrazovke, viditeľné bez ďalších klikov.
• Na každej stránke alebo obrazovke aplikácie, kde sa zobrazujú naše dáta — nielen na stránke "o nás".
• Čitateľná veľkosť a kontrast: aspoň ~11px, neskryté, nezbalené, nie vo farbe pozadia.
• Natívne mobilné aplikácie bez HTML odkazov: zobrazte text "Data by nakordoni.eu" na obrazovke s dátami a klikateľný odkaz umiestnite na informačnú obrazovku.

Atribúciu pravidelne overujeme na "stránke použitia dát" uvedenej pri registrácii. Chýbajúca alebo deindexovaná atribúcia v bezplatnom pláne Explorer vedie najprv k pripomienke, potom k pozastaveniu kľúča. Zákazníci s plateným plánom môžu atribúciu vynechať.

Licencia dát a trhy

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.
• Môžeme schváliť len niektoré z krajín, ktoré ste požiadali. Schválený zoznam, nie ten požiadaný, určuje, ktoré krajiny pokrýva vaša licencia.
• 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.

Aktualita údajov

Aktuálnosť vašich údajov závisí od vášho plánu. V samotnej odpovedi nie je žiadne označenie — každý plán vracia rovnaké polia, rovnaké typy a rovnakú štruktúru odpovede.

• Platené plány — Student, Starter, Pro a Pro MAX: živá telemetria, bez oneskorenia.
• Bezplatný plán Explorer: snímka za posledných 15 až 30 minút. Presný posun sa líši od požiadavky k požiadavke.

Oneskorená odpoveď nikdy nie je chyba ani problém s limitom — je to úplná, platná odpoveď so staršími číslami. Opakovanie požiadavky novšie údaje nevráti.

Ak vaša aplikácia potrebuje aktuálne údaje, každý platený plán vracia telemetriu v reálnom čase.

Získajte svoj bezplatný API kľúč