API hujjatlari

Autentifikatsiya

Har bir soʻrovga API kalitingiz Authorization sarlavhasida (tavsiya etiladi) yoki ?key= parametri sifatida kerak.

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

Javob konverti

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

Xatolar ok:false qiymatini error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) va HTTP holati 401/403/404/429/500 bilan qaytaradi. Tezlik chegarasi sarlavhalari X-Devapi-Limit va X-Devapi-Remaining har bir hisoblanadigan javobda yuboriladi.

Kvotalar

Kunlik hisoblagichlar UTC yarim tunda tiklanadi. Siz kvotaning 80% va 100% darajasida elektron xat olasiz.

Pullik tariflar bu cheklovlarning har birini ko'taradi. Joriy tariflar va ularning limitlari: Rejalar

Kod namunalari

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)

Power Query-ning o'rnatilgan JSON konnektori yordamida navbat, bashorat yoki yuk mashinalariga taqiqlar haqidagi jonli ma'lumotlarni to'g'ridan-to'g'ri ish daftariga oling — kodsiz, jadval bo'yicha yangilanadi. Xuddi shu Headers namunasi ushbu API-dagi har qanday mahsulot uchun ishlaydi — faqat URL-ni o'zgartiring.

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

API kalitini varaq katagida emas, M so'rovi ichida saqlang (Home → Advanced Editor) — maxfiylik darajasi Organizational qilib o'rnatilmagan bo'lsa, Power Query boshqa so'rov yoki katakdan tuzilgan veb-so'rovni bloklaydi ("Formula.Firewall").

Bitta jadvalda bir nechta chegara nazorat punktlari (avtopark panellari) — 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

Excel-dagi Data → Refresh All yoki Power BI / Excel Online-dagi rejalashtirilgan yangilanish ma'lumotlarni dolzarb saqlaydi — polling kodisiz.

ERP integratsiyasi (BAS / BAF va 1C oilasidagi platformalar)

BAS / BAF va 1C oilasidagi boshqa platformalar bu API’ga rejalashtirilgan vazifadan to‘g‘ridan-to‘g‘ri murojaat qila oladi — HTTPConnection va ReadJSON, oraliq xizmatsiz. Eng ko‘p uchraydigan holat — Yevropa Ittifoqidagi yoqilg‘i narxlari saqlanadigan ma’lumotlar registrini yangilab turish.

Ma’lumotlar registrini yangilash (yoqilg‘i narxlari, barcha davlat bitta so‘rovda)

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

Uch narsani to‘g‘ri bajaring: 443-portga New OpenSSLSecureConnection uzating, aks holda so‘rov TLS’da yiqiladi; /api/v1/data/fuel’ni country parametrisiz chaqiring — bitta so‘rov har bir davlat uchun alohida chaqiruv o‘rniga hammasini qaytaradi; va data’ga tegishdan oldin ok qiymatini tekshiring — xatolar istisno sifatida emas, ok:false va error.code ko‘rinishida keladi. Namunada platformaning inglizcha kalit so‘zlari ishlatilgan; mahalliylashtirilgan muqobillari (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) xuddi shunday ishlaydi.

Manbalardagi yoqilg‘i narxlari kuniga bir marta o‘zgaradi, shuning uchun kuniga bir yoki ikki marta ishlaydigan rejalashtirilgan vazifa yetarli va bepul Explorer kvotasi ichida qoladi. Navbatning jonli ma’lumotlari (queue, multi, border) bir necha daqiqada o‘zgaradi — ularni o‘z jadvalingiz bo‘yicha so‘rang va sikl o‘rniga multi orqali 5 tagacha o‘tkazish punktini bitta so‘rovda o‘qing.

MCP server

REST o'rniga vositalarni chaqirishni afzal ko'rasizmi? Biz ushbu API-ning xavfsiz, faqat o'qish uchun mo'ljallangan qismini MCP vositalari sifatida taqdim etuvchi haqiqiy MCP serverini (Streamable HTTP transporti) ishga tushiramiz — bir xil API kaliti, bir xil kvota, faqat boshqa transport.

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

Mijoz konfiguratsiyasi (Claude Desktop / Claude Code):

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

Mahsulotlar

Toʻliq maʼlumotnoma, parametrlar, versiyalar va jonli sinov maydoni uchun yakuniy nuqtani tanlang.

Standart standart maʼlumotlar kvotasidan foydalanadi  ·  Og'ir bashorat va statistika kvotasidan foydalanadi — qarang Kvotalar

Chegara navbatlari

Prognozlar va statistika

Yoqilg'i va joylashuvlar

Sayohat rejalashtirish

Haydovchilar va yo'llar

Your Fleet (NakBus Live)

AI yordamchi

Tarixiy maʼlumotlar eksporti

Tasdiqlangan dasturchilar 5 tagacha punkt boʻyicha soatlik oʻrtachalangan, eʼlon qilingan chegara navbati tarixini (90 kungacha suriluvchi oyna) gzip qilingan CSV, NDJSON yoki JSON koʻrinishida yuklab olishlari mumkin. Bu faqat portalga xos imkoniyat — API yakuniy nuqtasi EMAS; eksportlarni hisobingizdagi "Maʼlumot eksporti" boʻlimida shakllantirasiz va yuklab olasiz.

Ruxsat soʻrov asosida beriladi: qaysi punktlar, qaysi vaqt oraligʻi va maʼlumotni nima uchun ishlatishingizni koʻrsatib Maʼlumot tiketini oching. Tasdiqlangach, hisobingizda «Maʼlumot eksporti» boʻlimi paydo boʻladi. Standart chegara: kuniga 1 eksport, har birida 5 tagacha punkt — koʻpaytirishimizni soʻrang.

Maydonlar — har bir punkt va har bir UTC soati uchun bitta qator

Maʼlumotlar faqat eʼlon qilinganlar boʻlib, eksportdan oldin anomaliya / maʼlumot sifati tekshiruvlarimizdan oʻtadi (xom hisobot maʼlumotlari yoʻq). Barcha vaqt belgilari UTC. Fayllar 10 kun saqlanadi.

Kelib chiqishi: har bir fayl sarlavhasiga imzolangan barmoq izi (sha256 + HMAC) joylashtiradi, shu sababli istalgan nusxaning haqiqiy nakordoni.eu maʼlumoti ekanini keyinchalik tasdiqlash va oʻzgartirilgan-oʻzgartirilmaganini tekshirish mumkin — hatto yuklab olingandan keyin ham.

# 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

Nimalar qurishingiz mumkin

Aynan shu maʼlumot mahsulotlari nakordoni.eu saytidagi vizuallarni koʻrsatadi — haftalik prognoz grafiklari, soatlik navbat profillari, jonli holat kartalari. Prognoz va statistika API larida nimalar borligiga bir nazar tashlang:

Atributsiya

Explorer rejasi integratsiyalari maʼlumotlar koʻrsatilgan joyda koʻrinadigan "Data by nakordoni.eu" havolasini koʻrsatishi kerak. Bu bepul rejani bepul saqlaydi.

Aniq kod

Ushbu parchani oʻzgartirmasdan nusxalang. Havola indekslanadigan boʻlib qolishi kerak: qidiruv tizimlari kuzata oladigan oddiy HTML <a href> — rel="nofollow" yoki rel="sponsored" QOʻSHMANG, faqat JavaScript orqali koʻrsatmang va CSS bilan yashirmang.

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

Ixcham mayda variant (masalan, grafik yoki vidjet ostida):

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

Oʻz til versiyangizga havola qilishingiz mumkin, masalan https://nakordoni.eu/uz/ — nakordoni.eu-ga har qanday indekslanadigan havola hisoblanadi. "Data by nakordoni.eu" anchor matni inglizcha qolishi kerak.

Qayerga joylashtirish

• Maʼlumotlar blokining (jadval, grafik, vidjet, javob) yonida yoki ostida — oʻsha ekranda, qoʻshimcha bosishlarsiz koʻrinadigan.
• Bizning maʼlumotlar koʻrsatiladigan har bir sahifada yoki ilova ekranida — faqat "biz haqimizda" sahifasida emas.
• Oʻqiladigan oʻlcham va kontrast: kamida ~11px, yashirilmagan, yigʻilmagan, fon rangida emas.
• HTML havolalarsiz nativ mobil ilovalar: maʼlumotlar ekranida "Data by nakordoni.eu" matnini koʻrsating va bosiladigan havolani maʼlumot ekraniga joylashtiring.

Roʻyxatdan oʻtishda koʻrsatilgan "maʼlumotlar ishlatiladigan sahifada" atributsiyani vaqti-vaqti bilan tekshiramiz. Bepul Explorer rejasida atributsiyaning yoʻqligi yoki deindeksatsiyasi avval eslatmaga, soʻng kalitni toʻxtatishga olib keladi. Pullik rejadagi mijozlar atributsiyani tashlab ketishi mumkin.

Ma'lumotlar litsenziyasi va bozorlar

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.
• Siz soʻragan mamlakatlarning faqat ayrimlarini tasdiqlashimiz mumkin. Tasdiqlangan roʻyxat, soʻralgan roʻyxat emas, litsenziya qamrab olgan mamlakatlarni belgilaydi.
• 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.

Ma'lumotlarning yangiligi

Ma'lumotlarning yangiligi tarifingizga bog'liq. Javobning o'zida hech qanday belgi yo'q — barcha tariflar bir xil maydonlarni, bir xil turlarni va bir xil javob tuzilmasini qaytaradi.

• Pullik tariflar — Student, Starter, Pro va Pro MAX: kechikishsiz, jonli telemetriya.
• Bepul Explorer tarifi: so'nggi 15–30 daqiqadagi ma'lumot nusxasi. Aniq farq har bir so'rovda o'zgarib turadi.

Kechikkan javob hech qachon xato ham, limit muammosi ham emas — bu eskiroq raqamlar bilan to'liq va to'g'ri javob. So'rovni takrorlash yangiroq ma'lumot qaytarmaydi.

Agar ilovangizga dolzarb ma'lumotlar kerak bo'lsa, har qanday pullik tarif real vaqt telemetriyasini qaytaradi.

Bepul API kalitingizni oling