Xəbər göndərmə və NakBus donanması artıq tərəfdaş panelindədir
Developer hesabınızı eyni e-poçtla Nakordoni Partners hesabına qoşun və orada xəbərləri və avtobus donanmanızı (NakDriver / NakManager) komanda rolları ilə idarə edin. API açarlarınız, endpoint-lər və tətbiqlər dəyişməz qalır, buradakı səhifələr isə işləməkdə davam edir. Nakordoni Partners-i aç

API sənədləri

HTTPS üzərindən REST + JSON. Bir baza URL, bir açar, proqnozlaşdırıla bilən strukturlar.

Raw .md GitHub
Baza URLhttps://nakordoni.eu/api/v1/data/
FormatJSON, UTF-8
AutentifikasiyaAuthorization: Bearer NKD-DEV-…
VersiyalamaYolda versiyalaşdırma və hər endpoint üçün ayrıca: /api/v1/… sabitdir və cavabları heç vaxt dəyişmir. Daha yüksək versiya yolu (/api/v2/…, /api/v4/…) yeni davranışı yalnız dəyişmiş endpointlər üçün verir, qalanları üçün isə şəffaf şəkildə aşağı versiyaya qayıdır. Hər məhsul sənədləşdirdiyi ən yüksək versiyanı göstərir — bu qeydi yox, onu hədəfləyin. Əgər açarınızın çağırdığı versiyanı daha yenisi əvəz edərsə, sizə e-poçt göndərir və developer portalında bildiriş göstəririk — bunu dəyişikliklər siyahısından öyrənməli olmayacaqsınız.

Bu səhifədə

Autentifikasiya · Cavab strukturu · Kvotalar · Country and vehicle-type codes · Kod nümunələri · Excel / Power Query · ERP (BAS / 1C) · MCP server · İnteqrasiyalar üçün OAuth · İstinad · Məlumat lisenziyası və bazarlar · Məlumatların təzəliyi · Tarixi məlumatların ixracı · Nə qura bilərsiniz
Məhsullar Sərhəd növbələri: API Statusu · Nəzarət-buraxılış məntəqələri kataloqu API · Sərhəd növbəsi API v4 · Keçid məntəqəsi axtarış API · Canlı sərhəd növbəsi API · Genişləndirilmiş Gözləmə Vaxtı API-si · Bir neçə sərhəd buraxılış məntəqəsi API · Nəzarət məntəqəsi alternativləri API · Canlı növbə və təzəlik API  ·  Proqnozlar və Statistika: Növbə proqnozu API · Nəzarət məntəqəsinin saatlıq statistikası API · API «Keçmək üçün ən yaxşı vaxt»  ·  Yanacaq və Yerlər: Aİ yanacaq qiymətləri API v2 · Şəhərlər üzrə Yanacaq Qiymətləri API · Yaxınlıqdakı yanacaqdoldurma stansiyaları API · Yaxınlıqdakı ən ucuz yanacaq API · Yerli yanacaq qiymətləri API · Yanacaq növləri adlarının API-si · Sürücü POI-ləri API · Yük maşınları dayanacaqları API · Yaxınlıqdakı mağazalar API · Pulsuz duşlar API · Sürücülər üçün restoranlar API · Sənaye zonaları API · Valyuta məzənnəsi API  ·  Valyuta mübadilə məntəqələri: Mübadilə məntəqələri olan şəhərlər API · Valyuta mübadilə məntəqələri API · Mübadilə məntəqəsi məzənnələri API · Ən yaxşı mübadilə məzənnələri API · Mübadilə məzənnələri tarixçəsi API  ·  Səyahət Planlaması: Marşrut planlaşdırma API · Sərhəd səyahət matrisi API · Yük maşınlarının hərəkət qadağaları API v2 · Ticarət bazar günləri API · API Bayramlar Təqvimi  ·  Logistika: Truck Route API  ·  Sürücülər və Yollar: Yol şəraiti API v2 · Vinyetlər və yol haqları API · İnternet nöqtələri API · Avtobus daşıyıcısının sərhəd statistikası API · Sərhəddəki hava şəraiti API-si · Hava həyəcanı yaxınlığı API  ·  Your Fleet (NakBus Live): Avtopark nəqliyyat vasitələri API · Avtoparkın canlı mövqeləri API · Avtopark tarixçəsi API  ·  AI Köməkçisi: Sərhəd AI köməkçisi API · Fərdiləşdirilmiş AI köməkçi API-si

Autentifikasiya

Hər sorğu API açarınızı Authorization başlığında (tövsiyə olunur) və ya ?key= parametri kimi tələb edir.

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

Cavab strukturu

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

Xətalar ok:false qaytarır, error.code ilə (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, not_approved, bad_request, duplicate_request, market_not_allowed, internal_error, status_unavailable, timeout) və HTTP statusu 400/401/403/404/429/500/503/504. X-Devapi-Limit və X-Devapi-Remaining başlıqları hər ölçülən cavabla göndərilir. ok:false həlledicidir — uğursuz sorğuda data sahəsini heç vaxt oxumayın. usage obyekti hər ödənişli məhsulda mövcuddur; /status ictimaidir və ödənişsizdir, buna görə usage qaytarmır.

Kvotalar

Explorer
sorğu/gün standart məlumat API-lərində1,000
sorğu/gün proqnoz və statistika API-lərində200
yük maşını marşrutu çağırışı/gün10
QPS2

Günlük sayğaclar UTC gecə yarısı sıfırlanır. Kvotanın 80% və 100%-də e-poçt alırsınız.

Ödənişli planlar bu limitlərin hər birini artırır. Cari planlar və onların limitləri: Planlar

Kod nümunələri

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-nin daxili JSON konnektoru ilə növbə, proqnoz və ya yük maşınları üçün qadağa məlumatlarını birbaşa iş kitabına alın — koddan istifadə etmədən, cədvəl üzrə yenilənən. Eyni Headers sxemi bu API-dəki hər hansı məhsul üçün işləyir — sadəcə URL-i dəyişdirin.

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 açarını vərəq xanasında deyil, M sorğusunun daxilində saxlayın (Home → Advanced Editor) — məxfilik səviyyəsi Organizational olaraq təyin edilməyibsə, Power Query başqa sorğudan və ya xanadan qurulmuş veb sorğusunu bloklayır ("Formula.Firewall").

Bir cədvəldə bir neçə sərhəd keçid məntəqəsi (donanma paneli) — e.g. every truck crossing UA→PL (crossing_type=9; in v3 that one code covers both freight lanes):

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v4/data/border/1/2/9",
        [Headers = [Authorization = "Bearer " & ApiKey]])),
    checkpoints = Source[data],
    AsTable = Table.FromRecords(checkpoints)
in
    AsTable

Excel-də Data → Refresh All və ya Power BI / Excel Online-da planlaşdırılmış yeniləmə məlumatları aktual saxlayır — polling kodu tələb olunmur.

ERP inteqrasiyası (BAS / BAF və 1C ailəsi platformaları)

BAS / BAF və 1C ailəsinin digər platformaları bu API-yə birbaşa planlaşdırılmış tapşırıqdan müraciət edə bilər — HTTPConnection və ReadJSON, aralıq xidmət olmadan. Ən çox rast gəlinən ssenari Aİ yanacaq qiymətlərinin məlumat registrini güncəl saxlamaqdır.

Məlumat registrinin yenilənməsi (yanacaq qiymətləri, bütün ölkələr bir sorğuda)

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

Üç şeyi düzgün edin: 443 portuna New OpenSSLSecureConnection ötürün, əks halda sorğu TLS-də uğursuz olur; /api/v1/data/fuel-i country parametri olmadan çağırın ki, bir sorğu hər ölkə üçün ayrıca çağırış əvəzinə hamısını qaytarsın; və data-ya toxunmadan əvvəl ok dəyərini yoxlayın — xətalar istisna kimi deyil, error.code ilə ok:false şəklində gəlir. Nümunədə platformanın ingiliscə açar sözlər dəsti istifadə olunub; lokallaşdırılmış qarşılıqları (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) eyni işləyir.

Mənbələrdə yanacaq qiymətləri gündə bir dəfə dəyişir, ona görə gündə bir-iki dəfə işləyən planlaşdırılmış tapşırıq kifayətdir və pulsuz Explorer kvotasının çox içərisində qalır. Növbənin canlı məlumatları (queue, multi, border) hər bir neçə dəqiqədən bir dəyişir — onları öz cədvəlinizlə sorğulayın və dövr əvəzinə multi ilə bir sorğuda 5-yə qədər buraxılış məntəqəsini oxuyun.

MCP server

REST əvəzinə alət çağırışını üstün tutursunuz? Biz bu API-nin təhlükəsiz, yalnız oxumaq üçün olan alt dəstini MCP alətləri kimi təqdim edən əsl MCP server (Streamable HTTP nəqliyyatı) işlədirik — eyni API açarı, eyni kvota, sadəcə fərqli nəqliyyat.

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

Müştəri konfiqurasiyası (Claude Desktop / Claude Code):

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

İnteqrasiyalar üçün OAuth (Home Assistant və digərləri)

Hər istifadəçisinin öz açarına ehtiyacı olan inteqrasiyalar (Home Assistant fərdi inteqrasiyaları, masaüstü və mobil tətbiqlər) açar yapışdırmaq əvəzinə istifadəçiyə daxil olmağa imkan verə bilər. Axın PKCE (S256) ilə ictimai klientlər üçün OAuth 2.0 authorization code axınıdır — client secret yoxdur. Qaytardığımız giriş tokeni istifadəçinin öz NKD-DEV açarıdır; onu indiki kimi Bearer başlığı ilə göndərirsiniz.

Klientlər özünəxidmət deyil: İnteqrasiyalar səhifəsində müraciət edin, hər inteqrasiyanı əl ilə yoxlayırıq və icazə verilən yönləndirmə URI-ləri ilə client ID veririk. Təsdiqlənmiş klient vasitəsilə verilən açarlar həmin inteqrasiya üçün təsdiqlənmiş bazarlarda dərhal aktivləşir. İnteqrasiya klienti üçün müraciət edin →

GET https://api.nakordoni.dev/oauth/authorizeresponse_type=code, client_id, redirect_uri (qeydiyyatdan keçmiş URI ilə tam üst-üstə düşməlidir), state, code_challenge, code_challenge_method=S256
POST https://api.nakordoni.dev/oauth/tokengrant_type=authorization_code, code, code_verifier, redirect_uri, client_id — və ya grant_type=refresh_token, refresh_token, client_id
POST https://api.nakordoni.dev/oauth/revoketoken (refresh token və ya açarın özü), client_id
curl -X POST https://api.nakordoni.dev/oauth/token \
  -d grant_type=authorization_code -d client_id=nkd_xxxxxxxxxxxxxxxxxxxxxxxx \
  -d code=CODE -d code_verifier=VERIFIER \
  -d redirect_uri=https://my.home-assistant.io/redirect/oauth

{"access_token":"NKD-DEV-XXXX-XXXX-XXXX","token_type":"Bearer","expires_in":2592000,
 "refresh_token":"nkdrt_…","scope":"data","markets_approved":["DE"]}

Home Assistant

config_entry_oauth2_flow-nu LocalOAuth2ImplementationWithPkce (client_secret boş) və Home Assistant klientləri üçün əvvəlcədən qeydiyyatdan keçmiş https://my.home-assistant.io/redirect/oauth yönləndirmə URI-si ilə istifadə edin. Açarı entry.data["token"]["access_token"] daxilindən oxuyun və API-ni Authorization: Bearer ilə çağırmağa davam edin. API-dən 401 aldıqda, Home Assistant-ın yenidən autentifikasiya təklif etməsi üçün ConfigEntryAuthFailed yaradın.

from homeassistant.helpers import config_entry_oauth2_flow

impl = config_entry_oauth2_flow.LocalOAuth2ImplementationWithPkce(
    hass, DOMAIN, client_id="nkd_xxxxxxxxxxxxxxxxxxxxxxxx",
    authorize_url="https://api.nakordoni.dev/oauth/authorize",
    token_url="https://api.nakordoni.dev/oauth/token",
)
config_entry_oauth2_flow.async_register_implementation(hass, DOMAIN, impl)

İnteqrasiyalar: qalan limitləri göstərin

GET /api/v2/account/usage — Çağırdığınız açar üçün limitlərinizdən hazırda nə qaldığı: plan, saniyəlik limit və hər gündəlik kvota sinfi (cheap, heavy, route) üçün limit, istifadə olunan, qalan və sıfırlanma vaxtı (UTC gecə yarısı); həmçinin bu açarın gördüyü ölkələriniz və planı harada yüksəltmək olar. Sayılmır, açar başına dəqiqədə 30 çağırış.

İnteqrasiya (OAuth) açarları inteqrasiyaya hansı məhsullar icazə verilməsindən asılı olmayaraq GET /api/v2/account/usage-i həmişə çağıra bilər. Rəqəmlər X-Devapi-Limit və X-Devapi-Remaining başlıqları ilə üst-üstə düşür; X-Devapi-Reset sıfırlanma vaxtını Unix timestamp kimi verir.

{"ok":true,"api_version":"v2","product":"account-usage","data":{
 "plan":{"slug":"explorer","name":"Explorer"},"qps":2,
 "quotas":{"cheap":{"limit":1000,"used":42,"remaining":958,"reset_at":"2026-10-17T00:00:00Z"},"heavy":{…},"route":{…}},
 "markets":{"approved":["DE"],"allowed":1,"available":["AT"],"key_bound":true},
 "pass":{"active":true,"expires_at":"2026-10-19T14:05:00Z","days_left":3},"upgrade_url":"https://nakordoni.eu/en/developers/billing",
 "pass_url":"https://nakordoni.eu/en/developers/billing?section=trip-pass#trip-pass"}}

Limitə çatanda xəta hara getməyi deyir: 429 quota_exceeded həmçinin error.reset_at (UTC gecəyarısı) və error.upgrade_url qaytarır; 403 market_not_allowed və 403 integration_product_not_allowed error.upgrade_url qaytarır. İnteqrasiya açarları həmçinin error.pass_url alır (Trip Pass, aşağıda).

Home Assistant: /account/usage-i ən çoxu 15 dəqiqədən bir sorğulayın və quotas.cheap.remaining əsasında «qalan çağırışlar» sensoru yaradın. Sorğular arasında X-Devapi-Remaining dəyərini adi çağırışlardan oxuyun. 429 quota_exceeded və ya 403 market_not_allowed olduqda error.upgrade_url linki ilə repair issue yaradın və çağırışları reset_at-a qədər dayandırın.

Trip Pass

İnteqrasiya istifadəçiləri Ödəniş səhifəsində Trip Pass ala bilərlər (1, 3, 7 və ya 14 gün, birdəfəlik ödəniş). Aktiv olduqca inteqrasiya açarı inteqrasiyanın bütün ölkələrini, gündə daha çox yük maşını marşrutu və məlumat çağırışı və daha yüksək sürət alır; inteqrasiyanın məhsulları, proqnoz limitləri və məlumat gecikməsi dəyişmir. Eyni hesabın developer açarları heç vaxt artırılmır.

İnteqrasiya açarları üçün account/usage pass: {active, expires_at, days_left} və pass_url (Ödəniş səhifəsinin Trip Pass bölməsi) qaytarır; 429 quota_exceeded və 403 market_not_allowed / integration_product_not_allowed eyni error.pass_url daşıyır. Digər açarlar üçün hər ikisi null-dur.

Country and vehicle-type codes

Border endpoints address countries and vehicle types by numeric id: /api/v1/data/border/{origin}/{destination}/{crossing_type}. destination also accepts a comma-separated list or the word all. The ids are stable and are the same in every product that takes an origin, a destination or a crossing_type.

Country ids

The border products accept the ids marked as origins below; the neighbours column is what destination=all expands to for that origin. Ids without neighbours are countries we name in responses but hold no crossings for yet. The Checkpoints Directory returns the origin, destination and crossing_type of every crossing we actually serve, so it stays the authoritative list.

id Country Borders with (destination ids)
1 Ukrayna 2, 3, 4, 5, 6, 7
2 Polşa 1, 7, 18
3 Slovakiya 1
4 Macarıstan 1, 5, 13
5 Rumıniya 1, 4, 6, 12, 13
6 Moldova 1, 5
7 Belarus 1, 2, 8, 9
8 Litva 7
9 Latviya 7
11 Sloveniya 16, 20
12 Bolqarıstan 5, 13, 14, 15, 19
13 Serbiya 4, 5, 12, 15, 16, 17, 22, 23
14 Türkiyə 12, 19
15 Şimali Makedoniya 12, 13, 19, 21, 23
16 Xorvatiya 11, 13, 17, 22
17 Bosniya və Herseqovina 13, 16, 22
18 Almaniya 2
19 Yunanıstan 12, 14, 15, 21
20 İtaliya 11
21 Albaniya 15, 19, 22, 23
22 Monteneqro 13, 16, 17, 21, 23
23 Kosovo 13, 15, 21, 22
24 Avstriya —
25 Çexiya —
26 Fransa —
27 İspaniya —
28 Birləşmiş Krallıq —
29 Niderlandiya —
30 Belçika —
31 Portuqaliya —
33 Estoniya —
34 İsveçrə —
35 Danimarka —
36 Finlandiya —
37 Lüksemburq —
38 Norveç —
39 İsveç —

Vehicle types (crossing_type)

id Vehicle type Accepted by /border/
4 Avtomobil ✔
5 Avtomobil. Tax Free ✔
6 Avtobus ✔
7 Piyada ✔
8 Yük Nəqliyyatı ✔
9 7.5 tona qədər Yük Nəqliyyatı ✔
10 Bərə Keçidi - Avtomobil —
11 Bərə Keçidi - Avtobus —
12 Bərə Keçidi - Piyada —
13 Bərə Keçidi - Yük Nəqliyyatı —
14 3.5 tona qədər Yük Nəqliyyatı —

The label in this table is the crossing_type_label the API returns with every response, in the language you request. Types outside the accepted list belong to crossings the directory carries but the border products do not answer for — ferry (10-13), freight up to 3.5 t (14) and rail (15) — and asking for one returns 400, not an empty result. Read crossing_type from the Checkpoints Directory rather than assuming: a crossing returns data only for the types it actually has.

Məhsullar

Degraded performance Checked 2026-10-20T10:16:12Z · Live JSON: GET /api/v1/data/status (no key) · full status page

Tam arayışı, parametrləri, versiyaları və canlı sınaq mühitini görmək üçün son nöqtə seçin.

Standart standart məlumat kvotasından istifadə edir  ·  Ağır proqnoz və statistika kvotasından istifadə edir — bax Kvotalar  ·  Yük maşını marşrutu öz yük maşını marşrutu kvotasından istifadə edir — bax: Kvotalar

Sərhəd növbələri

API Statusu Standart

Hər Developer API məhsulunun canlı vəziyyəti: onlayn / deqradasiyaya uğramış / oflayn, cavab gecikmesi və son yoxlama vaxtı. İcti…

Nəzarət-buraxılış məntəqələri kataloqu API StandartOnline

Bütün monitorinq edilən sərhəd nəzarət-buraxılış məntəqələrinin kataloqu: identifikatorlar, adlar, ölkələr, koordinatlar və statu…

Sərhəd növbəsi API AğırOnlinev4

Müəyyən bir sərhəddəki bütün keçid məntəqələri + nəqliyyat növü bir sorğuda. Tək bir təyinat, vergüllə ayrılmış siyahı və ya "all…

Keçid məntəqəsi axtarış API StandartOnline

İstənilən dildə adı ilə keçid məntəqəsinin PPID-lərini tapın. Həmin yer üçün nəqliyyat növünə görə qruplaşdırılmış bütün PPID-lər…

Canlı sərhəd növbəsi API AğırOnline

Real vaxtda növbələr, gözləmə vaxtının qiymətləndirilməsi və istənilən keçid məntəqəsinin statusu. Snapshot bloku daxildir: cari …

Genişləndirilmiş Gözləmə Vaxtı API-si AğırOnline

Wait time adjusted for live traffic flow and weather, with a full breakdown of each adjustment, plus the same wait_status/trend f…

Bir neçə sərhəd buraxılış məntəqəsi API AğırOnline

Bir sorğuda 5-ə qədər sərhəd buraxılış məntəqəsi üçün növbə statusunu və məlumat təzəliyini alın. Kvota ⌈(N PPID × alt məhsullar)…

Nəzarət məntəqəsi alternativləri API StandartOnline

Eyni sərhəddə yaxınlıqdakı alternativ nəzarət məntəqələri cari növbələr və məsafə fərqləri ilə.

Canlı növbə və təzəlik API StandartOnline

Nəzarət məntəqəsinin son dəfə nə vaxt, hansı mənbədən yeniləndiyi və təzəlik reytinqi.

Proqnozlar və Statistika

Növbə proqnozu API AğırOnline

Növbə səviyyələrinin ML ansambl proqnozu: etibarlılıq hüdudları ilə 24 saatlıq və 7 günlük (168s) üfüqlər. nakordoni.eu proqnozla…

Nəzarət məntəqəsinin saatlıq statistikası API AğırOnline

Nəzarət məntəqəsi və tarix üzrə saatlıq tarixi növbə statistikası: 24 saatlıq dəyər, günlük orta/min/maks, pik və ən sakit saatla…

API «Keçmək üçün ən yaxşı vaxt» StandartOnline

Nəzarət nöqtəsi üzrə tipik həftə statistikası: 7×24 matris həftə-günü×saat (mediana + p25/p75 zolağı), ən sakit/sıx gün, ən yaxşı…

Yanacaq və Yerlər

Aİ yanacaq qiymətləri API StandartOnlinev2

EU ölkələrində yanacaq qiymətləri — country üzrə ortalamalar, koordinatlara görə ən yaxın stansiyalar və ya sərhəd keçid məntəqəs…

Şəhərlər üzrə Yanacaq Qiymətləri API StandartOnline

Şəhərlər üzrə yanacaq qiymətləri: ən ucuz stansiya və 5 ən ucuz stansiya ortalama.

Yaxınlıqdakı yanacaqdoldurma stansiyaları API StandartOnlinev2 yalnız

Nöqtəyə və ya şəhərə ən yaxın yanacaqdoldurma məntəqələri, hər yanacaq növü üzrə cari qiymətlərlə, məsafəyə görə sıralanmış. Mənt…

Yaxınlıqdakı ən ucuz yanacaq API StandartOnlinev2 yalnız

Nöqtə və ya şəhər ətrafındakı ən ucuz yanacaqdoldurma məntəqələri, seçilmiş yanacaq növü üzrə qiymətə görə sıralanmış (bərabərlik…

Yerli yanacaq qiymətləri API StandartOnlinev2 yalnız

Avropada İSTƏNİLƏN nöqtə üçün mövcud olan ən yaxşı yanacaq qiyməti, üç səviyyəli ehtiyat pilləkəni ilə müəyyən edilir ki, məlumat…

Yanacaq növləri adlarının API-si StandartOnlinev2 yalnız

Hər yanacaq məhsulunun arxasında duran adlandırma cədvəli: bizim kanonik marka lüğətimiz (diesel, premdiesel, truckdiesel, hvo, p…

Sürücü POI-ləri API StandartOnline

Avropa üzrə koordinatları olan yük maşınları dayanacaqları (14k+), pulsuz duşlar, xidmətlər və supermarketlər. Nəticələr ən yaxın…

Yük maşınları dayanacaqları API StandartOnlinev2 yalnız

Nöqtəyə və ya city'yə ən yaxın yük maşınları dayanacaqları, Autohöfe və istirahət məntəqələri — məsafəyə görə distance_km, ad, ko…

Yaxınlıqdakı mağazalar API StandartOnlinev2 yalnız

Nöqtəyə və ya city'yə ən yaxın supermarketlər və ərzaq mağazaları — məsafəyə görə distance_km, ad, koordinatlar və country ilə sı…

Pulsuz duşlar API StandartOnlinev2 yalnız

Nöqtəyə və ya city'yə ən yaxın sürücülər üçün pulsuz duşlar — məsafəyə görə distance_km, ad, koordinatlar və country ilə sıralanı…

Sürücülər üçün restoranlar API StandartOnlinev2 yalnız

Nöqtəyə və ya city'yə ən yaxın sürücülər üçün əlverişli restoranlar — məsafəyə görə distance_km, ad, koordinatlar və country ilə …

Sənaye zonaları API StandartOnlinev2 yalnız

Nöqtəyə və ya city'yə ən yaxın sənaye və logistika zonaları (Avropa üzrə 3k+-dan çox) — məsafəyə görə distance_km, ad, koordinatl…

Valyuta məzənnəsi API StandartOnline

PLN, CZK, HUF, USD, GBP, CHF, NOK və UAH üçün EUR əsaslı məzənnələr, mənbə Frankfurter (ECB), keş 6 saat. Parametrsiz — həmişə ta…

Valyuta mübadilə məntəqələri

Mübadilə məntəqələri olan şəhərlər API StandartOnlinev2 yalnız

Valyuta mübadilə məntəqələrini (kantors) göstərdiyimiz Polşa şəhərləri: hər birində neçə məntəqə var və onlardan neçəsi hazırda m…

Valyuta mübadilə məntəqələri API StandartOnlinev2 yalnız

Polşadakı valyuta mübadilə məntəqələrinin (kantors) kataloqu: ad, ünvan, koordinatlar, iş saatları, telefon, veb-sayt və məntəqən…

Mübadilə məntəqəsi məzənnələri API StandartOnlinev2 yalnız

PLN-ə qarşı cari alış və satış məzənnələri ilə bir mübadilə məntəqəsi. Pərakəndə və topdan məzənnələr ayrıca qaytarılır: topdan m…

Ən yaxşı mübadilə məzənnələri API StandartOnlinev2 yalnız

Bir şəhərdə elə indi bir valyutanı PLN-ə harada almaq və ya satmaq olar: ən yaxşı PƏRAKƏNDƏ məzənnələri olan məntəqələr reytinqlə…

Mübadilə məzənnələri tarixçəsi API AğırOnlinev2 yalnız

Bir valyutanın PLN-ə qarşı pərakəndə məzənnəsinin tarixçəsi — bir məntəqə və ya bütün şəhər üçün (onun məntəqələri üzrə orta və ə…

Səyahət Planlaması

Marşrut planlaşdırma API AğırOnlinev2 yalnız

Sərhəd səfəri üçün qapıdan-qapıya plan: marşrut, onun üzərindəki keçid məntəqələri canlı növbə və ya gəliş vaxtınıza proqnozla, h…

Sərhəd səyahət matrisi API AğırOnline

Verilən başlanğıc nöqtəsindən bütün keçid məntəqələri üçün yol müddəti və sərhəd növbəsi.

Yük maşınlarının hərəkət qadağaları API StandartOnlinev2

Avropa üzrə yük maşınlarının hərəkət məhdudiyyətləri country və tarixə görə, mövsümi və bayram qadağaları daxil olmaqla. Hər qada…

Ticarət bazar günləri API StandartOnline

Bazar günü pərakəndə açılış qaydaları və hər tənzimlənən Aİ ölkəsi üzrə qarşıdan gələn ticarət bazar günləri.

API Bayramlar Təqvimi StandartOnline

Avropa ülkələri üzrə rəsmi ictimai tətillər — tarixlər, yerli adlar və tətil tipi, hər ülkənin tam tətil siyahısı daxildir. Nakor…

Logistika

Truck Route API Yük maşını marşrutuOnlinev2 yalnız

Marşrut boyunca yanacaqdoldurma məntəqələri və yük maşını parkinqləri, həmçinin çəki məntəqələri və sürücünün istirahət planı ola…

Sürücülər və Yollar

Yol şəraiti API StandartOnlinev2

Sərhədlər yaxınlığında və əsas dəhlizlərdə təsdiqlənmiş yol şəraiti hesabatları: çuxurlar, yol işləri, bağlanmalar, buz, təhlükəl…

Vinyetlər və yol haqları API StandartOnlinev2 yalnız

country magistral yolla səyahət üçün vinyet tələb edirmi, müddətə görə cari qiymətlər və ətraflı məlumatı haradan oxumaq olar — c…

İnternet nöqtələri API StandartOnlinev2 yalnız

Yolda olan sürücülər üçün faydalı mobil operator mağazaları və WiFi nöqtələri, nöqtəyə və ya city'yə ən yaxından başlayaraq dista…

Avtobus daşıyıcısının sərhəd statistikası API StandartOnline

Avtobus daşıyıcısı üzrə sərhəd keçidi göstəriciləri: keçidlər, orta/median/min/maks gözləmə dəqiqələri — öz nömrə ilə uyğunlaşdır…

Sərhəddəki hava şəraiti API-si StandartOnline

Sərhəd buraxılış məntəqəsindəki yol təhlükəsi vahid 0–5 şkalası üzrə: təmiz yol, duman, qar, yağış, buzlaşma və ya güclü külək — …

Hava həyəcanı yaxınlığı API StandartOnlinev2 yalnız

Air-raid alerts and airborne objects near ONE border crossing. Anchor on a checkpoint (ppid), a coordinate pair or a city and get…

Your Fleet (NakBus Live)

Avtopark nəqliyyat vasitələri API StandartOnlinev2 yalnız

Öz NakBus Live parkınız: şirkətinizə qeydiyyatdan keçmiş hər bir nəqliyyat vasitəsi — dövlət nömrəsi, etiket, təyin edilmiş marşr…

Avtoparkın canlı mövqeləri API StandartOnlinev2 yalnız

Avtobuslarınızın məhz indi harada olması — hər aktiv nəqliyyat vasitəsi üçün bir sətir, lat/lon, vaxt möhürü və onun yaşı, sürət,…

Avtopark tarixçəsi API AğırOnlinev2 yalnız

Öz nəqliyyat vasitələrinizin yazılmış GPS izi: vaxt pəncərəsindəki hər saxlanmış mövqe nöqtəsi, xronoloji ardıcıllıqla, sürət, is…

AI Köməkçisi

Sərhəd AI köməkçisi API AğırOnline

Bizim istehsalat AI köməkçimizə hər hansı sərhəd keçidi sualını verin (növbələr, proqnozlar, qaydalar, yanacaq, marşrutlar) və na…

Fərdiləşdirilmiş AI köməkçi API-si AğırOnlinev2 yalnız

Öz AI köməkçiniz — SİZİN məzmununuz və BİZİM canlı sərhəd məlumatlarımız əsasında cavab verir. Bizə markdown fayllarınızı verin v…

Digər

Hesab istifadəsi API Standartv2 yalnız

Çağırdığınız açar üçün limitlərinizdən hazırda nə qaldığı: plan, saniyəlik limit və hər gündəlik kvota sinfi (cheap, heavy, route…

Shade Walking Route API AğırOnlinev2 yalnız

Pedestrian routes ranked by how much of the way lies in building and tree shade at the time of the walk (heat) or in sun (cold). …

Shade Grid API StandartOnlinev2 yalnız

Shade per H3 resolution-11 hex (about 25 m) for a small bounding box at a given time: share of open ground in building shade and …

Shade Walk Windows API StandartOnlinev2 yalnız

Shade share and pavement temperature estimate of one walk for every 15-minute departure in the next hours, and the best window. P…

Cool Spots for Dogs API StandartDegradedv2 yalnız

Places to cool a dog down near a point: safe water access on lake and river shores, bathing places, drinking water, forests, all-…

Cool Spots for Dogs Along a Walk API StandartOnlinev2 yalnız

Cool spots for dogs along a walking route: every spot within the corridor with its position along the walk and the shade at the t…

Cool Spots Along a Route API StandartOnlinev2 yalnız

Truck-accessible stops within 2 km of a route you already have: truck parkings shaded by trees (canopy share within 100 m), rest …

Tarixi məlumatların ixracı

Təsdiqlənmiş developerlər 5-ə qədər keçid məntəqəsi üzrə saatlıq ortalanmış, dərc olunmuş sərhəd növbəsi tarixçəsini (90 günə qədər sürüşən pəncərə) gzip-lənmiş CSV, NDJSON və ya JSON kimi endirə bilər. Bu, yalnız portala aid funksiyadır — API son nöqtəsi DEYİL; ixracları hesabınızdakı "Data ixracı" bölməsində qurur və endirirsiniz.

Giriş sorğu əsasında verilir: hansı keçid məntəqələri, hansı zaman aralığı və məlumatı nə üçün istifadə edəcəyinizi göstərən Data bileti açın. Təsdiqləndikdən sonra hesabınızda Data ixracı bölməsi görünür. Standart limit: gündə 1 ixrac, hər birində 5-ə qədər keçid məntəqəsi — artırmağımızı istəyin.

Sahələr — hər keçid məntəqəsi və hər UTC saatı üçün bir sətir

ParametrTəsvir
ppidKeçid məntəqəsinin id-si
checkpoint_nameKeçid məntəqəsinin adı
hour_utcSaat intervalı, ISO-8601 UTC
directionməs. UA->PL
vehicle_typeavtomobil / avtobus / yük maşını / piyada
avg_queue_lengthSaatlıq orta növbə uzunluğu
avg_wait_minutesSaatlıq orta gözləmə; rəsmi gözləmə axını olmayan keçid məntəqələrində null
sample_countHəmin saatdakı müşahidələrin sayı

Məlumatlar yalnız dərc olunmuşlardır və ixracdan əvvəl anomaliya / məlumat keyfiyyəti yoxlamalarımızdan keçir (xam hesabat məlumatı yoxdur). Bütün zaman möhürləri UTC-dir. Fayllar 10 gün saxlanılır.

Mənşə: hər fayl başlığına imzalanmış barmaq izi (sha256 + HMAC) yerləşdirir, beləliklə istənilən nüsxənin əsl nakordoni.eu məlumatı olduğu sonradan təsdiqlənə və dəyişdirilib-dəyişdirilmədiyi yoxlanıla bilər — hətta endirildikdən sonra da.

# 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

Nə qura bilərsiniz

Eyni məlumat məhsulları nakordoni.eu-dakı vizualları yaradır — həftəlik proqnoz qrafikləri, saatlıq növbə profilləri, canlı status kartları. Proqnoz və statistika API-lərinin tərkibindən bir nümunə:

7-day border queue forecast chart built from the Forecast API
Həftəlik proqnoz + ən yüklü günün saatlıq profili — Forecast API (prediction_steps=168 / 24)
Hourly queue statistics chart built from the Statistics API
Hər keçid məntəqəsi üzrə saatlıq növbə qrafiki — Statistics API (stats?ppid=…&compare=1)

İstinad

Explorer planı inteqrasiyaları məlumatın göstərildiyi hər yerdə görünən "Data by nakordoni.eu" keçidi göstərməlidir. Pulsuz planı pulsuz saxlayan budur.

Dəqiq kod

Bu fraqmenti olduğu kimi köçürün. Keçid indeksləşə bilən olaraq qalmalıdır: məlumatların yanında görünən, sadə HTML <a href>, Google-un indeksləyə və izləyə biləcəyi — rel="nofollow", rel="sponsored" və ya rel="ugc" ƏLAVƏ ETMƏYİN və onu CSS ilə gizlətməyin. JavaScript ilə əlavə edilən keçid Google-un render etdiyi səhifədə görünürsə, uyğundur (Developer API Şərtləri v1.0, bölmə 8.1).

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

Kompakt xırda variant (məs., qrafik və ya vidcet altında):

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

Öz dil versiyanıza da keçid verə bilərsiniz, məsələn https://nakordoni.eu/az/ — nakordoni.eu-ya aparan hər hansı görünən adi HTML keçid sayılır. Anker mətni "Data by nakordoni.eu" ingilis dilində qalmalıdır.

Haraya yerləşdirilməli

Qeydiyyat zamanı göstərdiyiniz "məlumatların istifadə olunduğu səhifə"də atribusiyanı vaxtaşırı yoxlayırıq. Pulsuz Explorer planında atribusiyanın olmaması və ya gizlədilməsi əvvəlcə xatırlatmaya, sonra açarın dayandırılmasına gətirir. Ödənişli plan müştəriləri atribusiyanı buraxa bilər.

Yoxlamalar təxminən həftədə bir dəfə user agent-i NakordoniComplianceBot/1.0 ehtiva edən yoxlayıcımız tərəfindən aparılır. O, yalnız tərtibatçı panelinizdə göstərilən səhifələri açır, başqa keçidlərə keçmir və bu səhifələr üçün robots.txt-ni nəzərə almır, çünki məhz onları yoxlamağımızı istəmisiniz. Bot mühafizəsi və ya firewall naməlum crawler-ləri bloklayırsa, bu user agent-ə icazə verin — səhifəni aça bilməsək, sizə tiketlə yazacağıq.

Məlumat lisenziyası və bazarlar

API açarınız yalnız qeydiyyat zamanı bəyan etdiyiniz ölkələrdə məlumatlarımızdan istifadə etmək üçün lisenziya verir. Tam giriş verməzdən əvvəl hər bəyanı nəzərdən keçiririk, çünki məlumatlarımız öz məhsulumuzdur və harada dərc olunacağını bilmədən bazarlara lisenziya vermirik.

Məlumatların təzəliyi

Məlumatların nə qədər təzə olması tarifinizdən asılıdır. Cavabın özündə heç bir işarə yoxdur — bütün tariflər eyni sahələri, eyni tipləri və eyni cavab strukturunu qaytarır.

Gecikmiş cavab heç vaxt səhv və ya limit problemi deyil — bu, daha köhnə rəqəmləri olan tam və düzgün cavabdır. Sorğunu təkrarlamaq daha təzə məlumat qaytarmır.

Tətbiqinizə aktual məlumatlar lazımdırsa, istənilən ödənişli tarif real vaxt telemetriyası qaytarır.

Pulsuz API açarınızı əldə edin

Yeniləndi