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)

Ստացեք հերթերի, կանխատեսումների կամ բեռնատարների արգելքների կենդանի տվյալները ուղղակիորեն աշխատանքային գրքույկում՝ Power Query-ի ներկառուցված JSON կոնեկտորի միջոցով — առանց կոդի, ժամանակացույցով թարմացվող։ Նույն Headers-ի սխեման աշխատում է այս API-ի ցանկացած ապրանքի համար — բավական է փոխել միայն 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

Պահեք API բանալին M հարցման ներսում (Home → Advanced Editor), ոչ թե թերթիկի բջիջում — Power Query-ն արգելափակում է մեկ այլ հարցումից կամ բջիջից կառուցված վեբ հարցումը ("Formula.Firewall"), եթե գաղտնիության մակարդակը սահմանված չէ Organizational։

Մի քանի սահմանային անցակետեր մեկ աղյուսակում (նավատորմի վահանակներ) — 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-ում Data → Refresh All-ը կամ Power BI / Excel Online-ում ժամանակացույցով թարմացումը տվյալները թարմ է պահում — առանց հարցումների (polling) կոդի։

ERP ինտեգրում (BAS / BAF և 1C ընտանիքի հարթակներ)

BAS / BAF-ը և 1C ընտանիքի մյուս հարթակները կարող են այս API-ին դիմել ուղղակիորեն պլանավորված առաջադրանքից — HTTPConnection և ReadJSON, առանց միջանկյալ ծառայության։ Ամենատարածված սցենարը ԵՄ վառելիքի գների տեղեկատվական ռեգիստրը թարմ պահելն է։

Տեղեկատվական ռեգիստրի թարմացում (վառելիքի գներ, բոլոր երկրները մեկ հարցումով)

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

Երեք բան պետք է ճիշտ անել՝ փոխանցեք New OpenSSLSecureConnection 443 պորտով, այլապես հարցումը կկործանվի TLS-ի վրա; կանչեք /api/v1/data/fuel առանց country պարամետրի, որպեսզի մեկ հարցումը վերադարձնի բոլոր երկրները՝ յուրաքանչյուրի համար առանձին կանչի փոխարեն; և ստուգեք ok-ը՝ նախքան data-ին դիպչելը — սխալները վերադառնում են որպես ok:false՝ error.code-ով, ոչ թե որպես բացառություն։ Օրինակում օգտագործված է հարթակի անգլերեն հիմնաբառերի հավաքածուն; տեղայնացված համարժեքները (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) աշխատում են նույնությամբ։

Աղբյուրներում վառելիքի գները փոխվում են օրը մեկ անգամ, ուստի օրական մեկ-երկու անգամ աշխատող պլանավորված առաջադրանքը բավական է և մնում է անվճար Explorer քվոտայի սահմաններում։ Հերթերի կենդանի տվյալները (queue, multi, border) փոխվում են ամեն մի քանի րոպեն մեկ — դրանք հարցրեք ձեր սեփական ժամանակացույցով և ցիկլի փոխարեն multi-ով կարդացեք մինչև 20 անցակետ մեկ հարցումով։

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" }
    }
  }
}

Պրոդուկտներ

Ընտրեք endpoint՝ տեսնելու ամբողջական տեղեկատուն, պարամետրերը, տարբերակները և կենդանի Sandbox-ը։

Ստանդարտ օգտագործում է ստանդարտ տվյալների քվոտան  ·  Ծանր օգտագործում է կանխատեսման և վիճակագրության քվոտան — տես Քվոտաներ

Սահմանային հերթեր

Կանխատեսումներ և վիճակագրություն

Վառելիք և տեղեր

Ճամփորդության պլանավորում

Վարորդներ և ճանապարհներ

ԱԲ օգնական

Այլ

Պատմական տվյալների արտահանում

Հաստատված ծրագրավորողները կարող են ներբեռնել ժամային միջինացված, հրապարակված սահմանային հերթերի պատմությունը մինչև 5 անցակետի համար (շարժական պատուհան՝ մինչև 90 օր)՝ gzip-ված CSV, NDJSON կամ JSON ձևաչափով։ Սա պորտալի հնարավորություն է, ՈՉ թե API endpoint. արտահանումները կառուցում և ներբեռնում եք ձեր հաշվի «Տվյալների արտահանում» ներդիրից։

Մուտքը տրվում է հարցումով. բացեք 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/hy/ — հաշվվում է ցանկացած ինդեքսավորվող հղում nakordoni.eu-ին: «Data by nakordoni.eu» խարիսխի տեքստը պետք է մնա անգլերեն:

Որտեղ տեղադրել

• Անմիջապես տվյալների բլոկի կողքին կամ տակ (աղյուսակ, գրաֆիկ, վիջեթ, պատասխան)՝ նույն էկրանին, տեսանելի առանց լրացուցիչ սեղմումների:
• Յուրաքանչյուր էջում կամ հավելվածի էկրանին, որտեղ հայտնվում են մեր տվյալները, ոչ միայն «մեր մասին» էջում:
• Ընթեռնելի չափ և կոնտրաստ՝ առնվազն ~11px, ոչ թաքնված, ոչ ծալված, ոչ ֆոնի գույնով:
• HTML հղումներ չունեցող նատիվ բջջային հավելվածներ. ցուցադրեք «Data by nakordoni.eu» տեքստը տվյալների էկրանին, իսկ սեղմվող հղումը դրեք տեղեկատվական էկրանին:

Մենք պարբերաբար ստուգում ենք ատրիբուցիան գրանցման ժամանակ նշված «տվյալների օգտագործման էջում»: Explorer պլանում ատրիբուցիայի բացակայությունը կամ դեինդեքսավորումը նախ հիշեցման, ապա բանալու կասեցման է հանգեցնում: Pay As You Grow հաճախորդները կարող են բաց թողնել ատրիբուցիան:

Ստացեք ձեր անվճար API բանալին