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% квоте.

Plaćeni planovi podižu svaki od ovih limita. Aktuelni planovi i njihovi limiti: Планови

Примери кода

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 5 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 Квоте

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

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

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

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

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

Your Fleet (NakBus Live)

ВИ асистент

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

Одобрени програмери могу да преузму објављену историју граничних редова, усредњену по сату, за до 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 води прво до подсетника, затим до суспензије кључа. Клијенти на плаћеном плану могу изоставити атрибуцију.

Лиценца за податке и тржишта

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.
• Možemo odobriti samo neke od zemalja koje ste zatražili. Odobreni spisak, a ne onaj koji ste zatražili, određuje zemlje koje pokriva vaša licenca.
• 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.

Ažurnost podataka

Koliko su podaci sveži zavisi od vašeg plana. U samom odgovoru nema nikakve oznake — svi planovi vraćaju ista polja, iste tipove i istu strukturu odgovora.

• Plaćeni planovi — Student, Starter, Pro i Pro MAX: telemetrija uživo, bez kašnjenja.
• Besplatan Explorer plan: snimak poslednjih 15 do 30 minuta. Tačan pomak se razlikuje od zahteva do zahteva.

Odloženi odgovor nikada nije greška niti problem sa kvotom — to je potpun, ispravan odgovor sa starijim brojevima. Ponavljanje zahteva neće vratiti novije podatke.

Ako vašoj aplikaciji trebaju aktuelni podaci, svaki plaćeni plan vraća telemetriju u realnom vremenu.

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