API-dokumentáció

Hitelesítés

Minden kérésnek tartalmaznia kell az API-kulcsodat az Authorization fejlécben (ajánlott) vagy ?key= paraméterként.

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

Válaszburok

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

A hibák ok:false választ adnak error.code értékkel (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) és 401/403/404/429/500 HTTP-státusszal. Az X-Devapi-Limit és X-Devapi-Remaining sebességkorlát-fejléceket minden mért válaszban elküldjük.

Kvóták

A napi számlálók éjfélkor (UTC) nullázódnak. A kvóta 80%-ánál és 100%-ánál e-mailt kapsz.

A fizetős csomagok mindegyik korlátot megemelik. Az aktuális csomagok és kereteik: Csomagok

Kódminták

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)

Kérjen le élő sorállási, előrejelzési vagy teherautó-tilalmi adatokat közvetlenül egy munkafüzetbe a Power Query beépített JSON-konnektorával — kód nélkül, ütemezett frissítéssel. Ugyanaz a Headers-minta minden API-termékhez működik — csak az URL-t kell módosítani.

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

Az API-kulcsot az M-lekérdezésen belül tárolja (Home → Advanced Editor), ne egy munkalapcellában — a Power Query blokkolja a más lekérdezésből vagy cellából épített webes kérést ("Formula.Firewall"), hacsak az adatvédelmi szint nincs Organizational-ra állítva.

Több határátkelő egy táblázatban (flottapanelek) — 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

A Data → Refresh All az Excelben, vagy egy ütemezett frissítés a Power BI-ban / Excel Online-ban naprakészen tartja az adatokat — lekérdező (polling) kód nélkül.

ERP-integráció (BAS / BAF és 1C-családú platformok)

A BAS / BAF és a többi 1C-családú platform közvetlenül egy ütemezett feladatból hívhatja ezt az API-t — HTTPConnection és ReadJSON, köztes réteg és külön szolgáltatás nélkül. A leggyakoribb megoldás egy információs regisztert tart naprakészen az uniós üzemanyagárakkal.

Információs regiszter frissítése (üzemanyagárak, minden ország egyetlen hívásban)

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

Három dolgot kell eltalálni: adja át a New OpenSSLSecureConnection értéket a 443-as porton, különben a kérés elhasal a TLS-en; a /api/v1/data/fuel végpontot country paraméter nélkül hívja, így egyetlen kérés minden országot visszaad, ország per hívás helyett; és ellenőrizze az ok mezőt, mielőtt a data mezőhöz nyúlna — a hibák ok:false formában, error.code kóddal érkeznek, nem kivételként. A minta a platform angol kulcsszókészletét használja; a honosított megfelelők (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) ugyanúgy működnek.

Az üzemanyagárak a forrásnál naponta egyszer változnak, ezért egy napi egy- vagy kétszeri ütemezett feladat bőven elég, és messze az ingyenes Explorer kereten belül marad. Az élő sorállási adatok (queue, multi, border) percenként változnak — ezeket saját ütem szerint kérdezze le, és a multi végponttal olvasson be akár 5 határátkelőt egyetlen kérésben, ciklus helyett.

MCP-szerver

Inkább eszközhívást használna REST helyett? Egy valódi MCP-szervert (Streamable HTTP átvitel) üzemeltetünk, amely ennek az API-nak egy biztonságos, csak olvasható részhalmazát MCP-eszközökként teszi elérhetővé — ugyanaz az API-kulcs, ugyanaz a kvóta, csak más átvitel.

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

Kliens konfiguráció (Claude Desktop / Claude Code):

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

Termékek

Válassz egy végpontot a teljes referenciához, a paraméterekhez, a verziókhoz és az élő sandboxhoz.

Alapvető a standard adatkvótát használja  ·  Nehéz a prognózis és statisztikai kvóta alapján — lásd Kvóták

Határvárakozás

Előrejelzések és statisztikák

Üzemanyag és helyszínek

Utazástervezés

Sofőrök és utak

Your Fleet (NakBus Live)

AI Asszisztens

Történeti adatok exportja

A jóváhagyott fejlesztők legfeljebb 5 határátkelőre letölthetik az óránként átlagolt, közzétett határsor-előzményeket (legfeljebb 90 napos gördülő ablak) gzippelt CSV, NDJSON vagy JSON formátumban. Ez kizárólag portálfunkció — NEM API-végpont; az exportokat a fiókod „Adatexport” fülén állítod össze és töltöd le.

A hozzáférést kérésre adjuk meg: nyiss egy Adat jegyet, és írd meg, mely határátkelőkre, milyen időszakra és milyen célra van szükséged. Jóváhagyás után az Adatexport fül megjelenik a fiókodban. Alapértelmezett korlát: napi 1 export, egyenként legfeljebb 5 határátkelővel — kérésre megemeljük.

Mezők — határátkelőnként és UTC-óránként egy sor

Kizárólag közzétett adatokat exportálunk, amelyek átmennek az anomália- és adatminőség-ellenőrzéseinken (nyers, bejelentésenkénti adat nincs). Minden időbélyeg UTC. A fájlokat 10 napig őrizzük meg.

Eredet: minden fájl fejléce tartalmaz egy aláírt ujjlenyomatot (sha256 + HMAC), így bármelyik másolatról később igazolható, hogy valódi nakordoni.eu adat, és ellenőrizhető, nem módosították-e — még letöltés után is.

# 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

Mit építhetsz

Ugyanezek az adattermékek jelenítik meg a nakordoni.eu vizuális elemeit — heti előrejelzési diagramokat, óránkénti sorprofilokat, élő státuszkártyákat. Ízelítő abból, amit az előrejelzési és statisztikai API-k tartalmaznak:

Forrásmegjelölés

Az Explorer csomagú integrációknak látható „Data by nakordoni.eu” hivatkozást kell megjeleníteniük mindenhol, ahol az adatok megjelennek. Ez tartja ingyenesen az ingyenes csomagot.

A pontos kód

Másolja be ezt a kódrészletet változtatás nélkül. A linknek indexelhetőnek kell maradnia: sima HTML <a href>, amelyet a keresők követhetnek — NE adjon hozzá rel="nofollow" vagy rel="sponsored" attribútumot, ne csak JavaScripttel jelenítse meg, és ne rejtse el CSS-sel.

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

Kompakt, apróbetűs változat (pl. diagram vagy widget alatt):

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

Linkelhet a saját nyelvi verziójára is, pl. https://nakordoni.eu/hu/ — bármely indexelhető link a nakordoni.eu-ra megfelel. A "Data by nakordoni.eu" horgonyszövegnek angolul kell maradnia.

Hová helyezze

• Közvetlenül az adatblokk mellé vagy alá (táblázat, diagram, widget, válasz) — ugyanazon a képernyőn, külön kattintás nélkül láthatóan.
• Minden oldalon vagy alkalmazás-képernyőn, ahol adataink megjelennek — nem csak egy "rólunk" oldalon.
• Olvasható méret és kontraszt: legalább ~11px, nem rejtett, nem összecsukott, nem háttérszínű.
• HTML-linkek nélküli natív mobilappok: jelenítse meg a "Data by nakordoni.eu" szöveget az adatképernyőn, a kattintható linket pedig az infó képernyőre tegye.

Időnként ellenőrizzük az attribúciót a regisztrációkor megadott "adatfelhasználási oldalon". Hiányzó vagy deindexelt attribúció az ingyenes Explorer csomagban először emlékeztetőt, majd kulcsfelfüggesztést von maga után. A fizetős csomaggal rendelkező ügyfelek elhagyhatják az attribúciót.

Adatlicenc és piacok

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.
• Csak néhány, az általad megadott országot engedélyezhetjük. Az engedélyezett lista, nem pedig a kért lista határozza meg, hogy mely országokat fedik le a licenced.
• 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.

Adatok frissessége

Az adatok frissessége a csomagjától függ. A válaszban nincs erre vonatkozó jelölés — minden csomag ugyanazokat a mezőket, ugyanazokat a típusokat és ugyanazt a válaszszerkezetet adja vissza.

• Fizetős csomagok — Student, Starter, Pro és Pro MAX: élő telemetria, késleltetés nélkül.
• Ingyenes Explorer csomag: pillanatkép az elmúlt 15–30 percből. A pontos eltolás kérésenként változik.

A késleltetett válasz soha nem hiba és nem kvótaprobléma — teljes értékű, érvényes válasz, csak régebbi számokkal. Az ismételt lekérdezés nem ad frissebb adatot.

Ha az alkalmazásának aktuális adatokra van szüksége, bármelyik fizetős csomag valós idejű telemetriát ad.

Szerezd meg ingyenes API-kulcsod