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-ով կարդացեք մինչև 5 անցակետ մեկ հարցումով։

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-ը։

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

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

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

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

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

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

Your Fleet (NakBus Live)

ԱԲ օգնական

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

Հաստատված ծրագրավորողները կարող են ներբեռնել ժամային միջինացված, հրապարակված սահմանային հերթերի պատմությունը մինչև 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 պլանում ատրիբուցիայի բացակայությունը կամ դեինդեքսավորումը նախ հիշեցման, ապա բանալու կասեցման է հանգեցնում: Վճարովի պլանի հաճախորդները կարող են բաց թողնել ատրիբուցիան:

Տվյալների լիցենզիա և շուկաներ

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.
• Մենք կարող ենք հաստատել միայն այն երկրներից մի քանիսը, որոնք դուք խնդրել եք։ հաստատված ցանկը, ոչ թե խնդրածը, որոշում է, թե cuales países cubre su licencia.
• 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.

Տվյալների թարմություն

Տվյալների թարմությունը կախված է ձեր փաթեթից. պատասխանի մեջ որևէ նշում չկա — բոլոր փաթեթները վերադարձնում են նույն դաշտերը, նույն տիպերը և պատասխանի նույն կառուցվածքը։

• Վճարովի փաթեթներ՝ Student, Starter, Pro և Pro MAX. կենդանի հեռաչափություն, առանց ուշացման։
• Անվճար Explorer փաթեթ՝ վերջին 15–30 րոպեների կտրվածք։ Ճշգրիտ շեղումը հարցումից հարցում փոփոխվում է։

Ուշացած պատասխանը երբեք սխալ չէ և սահմանաչափի հետ կապված խնդիր չէ — դա լիարժեք, վավեր պատասխան է՝ ավելի հին թվերով։ Հարցումը կրկնելը ավելի թարմ տվյալներ չի վերադարձնի։

Եթե ձեր հավելվածին անհրաժեշտ են ընթացիկ տվյալներ, ցանկացած վճարովի փաթեթ վերադարձնում է հեռաչափություն իրական ժամանակում։

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