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.

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 20 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

AI Asszisztens

Egyéb

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 Explorer csomagban először emlékeztetőt, majd kulcsfelfüggesztést von maga után. A Pay As You Grow ügyfelek elhagyhatják az attribúciót.

Szerezd meg ingyenes API-kulcsod