API документација

Аутентификација

Сваки захтев захтева ваш API кључ у заглављу Authorization (препоручено) или као параметар ?key=.

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

Формат одговора

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

Грешке враћају ok:false са error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) и HTTP статусом 401/403/404/429/500. Заглавља за ограничење брзине X-Devapi-Limit и X-Devapi-Remaining шаљу се са сваким мереним одговором.

Квоте

Дневни бројачи се ресетују у поноћ по UTC. Добијате имејл на 80% и 100% квоте.

Примери кода

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)

Preuzmite podatke o redovima čekanja, prognozama ili zabranama za kamione direktno u radnu svesku pomoću ugrađenog JSON konektora u Power Query-ju — bez koda, sa osvežavanjem po rasporedu. Isti obrazac Headers-a radi za svaki proizvod ovog API-ja — samo promenite 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

Čuvajte API ključ unutar M upita (Home → Advanced Editor), a ne u ćeliji lista — Power Query blokira veb zahtev sastavljen iz drugog upita ili ćelije ("Formula.Firewall"), osim ako nivo privatnosti nije podešen na Organizational.

Više graničnih prelaza u jednoj tabeli (kontrolne table za vozni park) — 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 u Excel-u ili planirano osvežavanje u Power BI / Excel Online-u održava podatke ažurnim — bez koda za periodično proveravanje (polling).

Integracija sa ERP (BAS / BAF i platforme porodice 1C)

BAS / BAF i druge platforme porodice 1C mogu da pozovu ovaj API direktno iz zakazanog zadatka — HTTPConnection plus ReadJSON, bez međusloja i bez dodatnog servisa. Najčešća postavka održava ažurnim registar informacija sa cenama goriva u EU.

Osvežavanje registra informacija (cene goriva, sve zemlje u jednom pozivu)

// 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 stvari treba pogoditi: prosledite New OpenSSLSecureConnection na portu 443, inače zahtev pada na TLS; pozovite /api/v1/data/fuel bez parametra country da jedan zahtev vrati sve zemlje umesto poziva po zemlji; i proverite ok pre nego što dirnete data — greške se vraćaju kao ok:false sa error.code, a ne kao izuzetak. Primer koristi engleski skup ključnih reči platforme; lokalizovani ekvivalenti (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) ponašaju se isto.

Cene goriva se u izvorima menjaju jednom dnevno, pa je zakazani zadatak jednom ili dvaput dnevno sasvim dovoljan i ostaje duboko unutar besplatne Explorer kvote. Podaci o redovima uživo (queue, multi, border) menjaju se na svakih nekoliko minuta — njih povlačite po sopstvenom rasporedu i koristite multi da pročitate do 20 graničnih prelaza jednim zahtevom umesto u petlji.

MCP сервер

Више волите позивање алата него REST? Покрећемо прави MCP сервер (Streamable HTTP транспорт) који излаже безбедан подскуп овог API-ја само за читање као MCP алате — исти API кључ, иста квота, само другачији транспорт.

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

Конфигурација клијента (Claude Desktop / Claude Code):

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

Производи

Изаберите крајњу тачку за њену пуну референцу, параметре, верзије и Sandbox уживо.

Стандардни koristi standardnu kvotu podataka  ·  Тежак koristi kvotu prognoze i statistike — vidi Квоте

Редови на граници

Прогнозе и статистике

Гориво и локације

Планирање путовања

Возачи и путеви

ВИ асистент

Остало

Извоз историјских података

Одобрени програмери могу да преузму објављену историју граничних редова, усредњену по сату, за до 5 прелаза (клизни опсег до 90 дана) као gzip CSV, NDJSON или JSON. Ово је функција само у порталу — НИЈЕ API крајња тачка; извозе правите и преузимате са картице „Извоз података“ у свом налогу.

Приступ се одобрава на захтев: отворите тикет типа Data и реците нам које прелазе, у ком временском опсегу и за коју намену. Након одобрења, у вашем налогу се појављује картица „Извоз података“. Подразумевано ограничење: 1 извоз дневно, до 5 прелаза по извозу — тражите од нас да га повећамо.

Поља — по један ред за сваки прелаз за сваки UTC сат

Извозе се само објављени подаци, који пре тога пролазе наше провере аномалија и квалитета (без сирових појединачних пријава). Све временске ознаке су у UTC. Датотеке се чувају 10 дана.

Порекло: свака датотека у заглављу носи потписан отисак (sha256 + HMAC), тако да се било која копија касније може потврдити као аутентични подаци са nakordoni.eu и проверити на измене — чак и после преузимања.

# 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

Шта можете да изградите

Исти производи са подацима приказују визуелне елементе на nakordoni.eu — недељне графиконе прогноза, сатне профиле гужви, картице са статусом уживо. Кратак увид у то шта садрже API-ји за прогнозе и статистику:

Атрибуција

Интеграције по плану Explorer морају приказати видљиву везу „Data by nakordoni.eu“ свуда где се подаци приказују. То одржава бесплатан план бесплатним.

Тачан код

Копирајте овај фрагмент без измена. Линк мора остати индексабилан: обичан HTML <a href> који претраживачи могу да прате — НЕ додавајте rel="nofollow" или rel="sponsored", не рендерујте га само преко JavaScript-а и не скривајте га CSS-ом.

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

Компактна ситна варијанта (нпр. испод графикона или виџета):

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

Можете линковати ка својој језичкој верзији, нпр. https://nakordoni.eu/sr/ — рачуна се сваки индексабилан линк ка nakordoni.eu. Текст сидра "Data by nakordoni.eu" мора остати на енглеском.

Где га поставити

• Непосредно поред или испод блока података (табела, графикон, виџет, одговор) — на истом екрану, видљиво без додатних кликова.
• На свакој страници или екрану апликације где се појављују наши подаци — не само на страници "о нама".
• Читљива величина и контраст: најмање ~11px, не скривено, не склопљено, не у боји позадине.
• Нативне мобилне апликације без HTML линкова: прикажите текст "Data by nakordoni.eu" на екрану са подацима и поставите кликабилан линк на информативни екран.

Периодично проверавамо атрибуцију на "страници коришћења података" наведеној при регистрацији. Недостајућа или деиндексирана атрибуција у плану Explorer води прво до подсетника, затим до суспензије кључа. Клијенти Pay As You Grow могу изоставити атрибуцију.

Преузмите свој бесплатан API кључ