API sənədləri
HTTPS üzərindən REST + JSON. Bir baza URL, bir açar, proqnozlaşdırıla bilən strukturlar.
| Baza URL | https://nakordoni.eu/api/v1/data/ |
|---|---|
| Format | JSON, UTF-8 |
| Autentifikasiya | Authorization: Bearer NKD-DEV-… |
| Versiyalama | Yolda 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
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ün | 10 |
| QPS | 2 |
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/authorize | response_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/token | grant_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/revoke | token (refresh token və ya açarın özü), client_id |
- Avtorizasiya kodu 60 saniyə etibarlıdır, birdəfəlikdir və klientə, istifadəçiyə, yönləndirmə URI-nə və PKCE challenge-ə bağlıdır.
- Açar yalnız token cavabının gövdəsində (access_token) qaytarılır — heç vaxt URL-də deyil. Onu parol kimi saxlayın.
- expires_in 30 gündür; yeniləmə açar aktiv olduqca eyni açarı qaytarır. İstifadəçi açarı ləğv edərsə və ya yenidən yaradarsa, yeniləmə invalid_grant ilə uğursuz olur, API sorğuları isə 401 qaytarır — yenidən autentifikasiyanı başladın.
- Sorğular hər IP üçün tezlik baxımından məhdudlaşdırılıb və hər klient üçün gündəlik limitlə məhdudlaşdırılıb; xətalar RFC 6749 standartına uyğundur (error, error_description).
- Hər istifadəçi ən çox öz ölkə limitini alır: inteqrasiyanızda istifadəçinin boş yerlərindən çox ölkə varsa, o, onları razılıq səhifəsində seçir (əvvəlcədən seçim üçün /oauth/authorize-a markets=DE,AT göndərin). Hər iki token cavabı həmçinin markets_approved (istifadəçinin təsdiqlənmiş ölkələri), markets_allowed (onun limiti; null = limitsiz), markets_available (onda hələ olmayan ölkələriniz) və upgrade_url («Əlavə ölkələr» əlavə edəcəyi yer) qaytarır.
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
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
Hər Developer API məhsulunun canlı vəziyyəti: onlayn / deqradasiyaya uğramış / oflayn, cavab gecikmesi və son yoxlama vaxtı. İcti…
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…
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…
İ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…
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 …
Wait time adjusted for live traffic flow and weather, with a full breakdown of each adjustment, plus the same wait_status/trend f…
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)…
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ə.
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ə 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ə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…
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
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: ən ucuz stansiya və 5 ən ucuz stansiya ortalama.
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…
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…
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…
Hər yanacaq məhsulunun arxasında duran adlandırma cədvəli: bizim kanonik marka lüğətimiz (diesel, premdiesel, truckdiesel, hvo, p…
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…
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…
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ı…
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ı…
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ə …
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…
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
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…
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…
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…
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ə…
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ı
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…
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.
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…
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.
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
Sürücülər və Yollar
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…
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…
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ı ü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ə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 — …
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)
Ö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…
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,…
Ö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
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…
Ö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
Ç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…
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 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 share and pavement temperature estimate of one walk for every 15-minute departure in the next hours, and the best window. P…
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 walking route: every spot within the corridor with its position along the walk and the shade at the t…
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
| Parametr | Təsvir |
|---|---|
ppid | Keçid məntəqəsinin id-si |
checkpoint_name | Keçid məntəqəsinin adı |
hour_utc | Saat intervalı, ISO-8601 UTC |
direction | məs. UA->PL |
vehicle_type | avtomobil / avtobus / yük maşını / piyada |
avg_queue_length | Saatlıq orta növbə uzunluğu |
avg_wait_minutes | Saatlıq orta gözləmə; rəsmi gözləmə axını olmayan keçid məntəqələrində null |
sample_count | Hə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ə:
İ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 & 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
- Məlumat blokunun (cədvəl, qrafik, vidcet, cavab) dərhal yanında və ya altında — eyni ekranda, əlavə kliklər olmadan görünən.
- Məlumatlarımızın göründüyü hər səhifədə və ya tətbiq ekranında — yalnız "haqqımızda" səhifəsində deyil.
- Oxuna bilən ölçü və kontrast: ən azı ~11px, gizlədilməmiş, yığılmamış, fon rəngində deyil.
- HTML keçidləri olmayan nativ mobil tətbiqlər: məlumat ekranında "Data by nakordoni.eu" mətnini göstərin və kliklənə bilən keçidi məlumat ekranına qoyun.
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.
- Saytınızın, tətbiqinizin və ya məhsulunuzun xidmət göstərdiyi hər ölkəni bəyan edin. Siyahını istənilən vaxt idarə panelinizdən dəyişə bilərsiniz; dəyişiklik hesabınızı yenidən nəzərdən keçirməyə qaytarır.
- Bazarlarınız təsdiqlənənə qədər açarınız azaldılmış limitlərlə işləyir — Starter planı payının yarısı. Bu, hansı planda olmağınızdan asılı olmayaraq tətbiq olunur.
- Sizin istədiyiniz ölkələrin yalnızca bəzi hissəsini təsdiqləyə bilərik. Təsdiqlənmiş siyahı, sizin istədiyiniz deyil, lisenziyanızın əhatə etdiyi ölkələri müəyyən edir.
- Bəyan etmədiyiniz bazarda məlumatlarımızı dərc etmək və ya yaymaq, yaxud onları rəqib məlumat axını kimi yenidən satmaq bu şərtlərin pozulmasıdır və açarınızı xəbərdarlıq etmədən dayandıra bilər.
- Bəzi planlar yalnız seçilmiş regionlarda təklif olunur. Mövcudluq bəyan etdiyiniz bazarlardan asılıdır.
- Tam müqavilə Developer API Şərtləri sənədidir. O, bu qısa xülasədən üstündür; hüquqi qüvvəyə malik olan ingilis dilindəki mətndir.
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.
- Ödənişli tariflər — Student, Starter, Pro və Pro MAX: gecikmə olmadan canlı telemetriya.
- Pulsuz Explorer tarifi: son 15–30 dəqiqənin anlıq görüntüsü. Dəqiq fərq sorğudan sorğuya dəyişir.
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