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",
  "terms": "https://nakordoni.eu/en/p/developer_api_terms",
  "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, not_approved, bad_request, duplicate_request, market_not_allowed, internal_error, status_unavailable, timeout) և HTTP կարգավիճակով 400/401/403/404/429/500/503/504: X-Devapi-Limit և X-Devapi-Remaining վերնագրերը ուղարկվում են յուրաքանչյուր հաշվառվող պատասխանի հետ: ok:false-ը որոշիչ է — ձախողված կանչում երբեք մի կարդացեք data դաշտը։ usage օբյեկտը առկա է յուրաքանչյուր վճարովի ծառայությունում. /status-ը հանրային է և չի հաշվառվում, ուստի usage չի վերադարձնում։

Քվոտաներ

Օրական հաշվիչները զրոյանում են 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→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-ում 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" }
    }
  }
}

OAuth ինտեգրացիաների համար (Home Assistant և այլն)

Ինտեգրացիաները, որոնց յուրաքանչյուր օգտատիրոջն անհրաժեշտ է սեփական բանալի (Home Assistant-ի հարմարեցված ինտեգրացիաներ, դեսքթոփ և բջջային հավելվածներ), կարող են օգտատիրոջը թույլ տալ մուտք գործել՝ բանալին տեղադրելու փոխարեն։ Հոսքը OAuth 2.0 authorization code է հանրային հաճախորդների համար՝ PKCE-ով (S256). client secret չկա։ Մեր վերադարձրած մուտքի թոքենը օգտատիրոջ սեփական NKD-DEV բանալին է, որը դուք ուղարկում եք Bearer վերնագրով՝ հենց այնպես, ինչպես մինչ այժմ։

Հաճախորդները ինքնասպասարկմամբ չեն ստեղծվում. դիմեք Ինտեգրացիաների էջում, յուրաքանչյուր ինտեգրացիա ստուգում ենք ձեռքով և տրամադրում client ID՝ թույլատրված վերաուղղորդման URI-ներով։ Հաստատված հաճախորդի միջոցով տրված բանալիներն անմիջապես ակտիվանում են տվյալ ինտեգրացիայի համար հաստատված շուկաներում։ Դիմել ինտեգրացիայի հաճախորդի համար →

• Թույլտվության կոդը վավեր է 60 վայրկյան, միանգամյա է և կապված է հաճախորդի, օգտատիրոջ, վերաուղղորդման URI-ի և PKCE challenge-ի հետ։
• Բանալին վերադարձվում է միայն թոքենի պատասխանի մարմնում (access_token), երբեք՝ URL-ում։ Պահեք այն որպես գաղտնաբառ։
• expires_in-ը 30 օր է. թարմացումը վերադարձնում է նույն բանալին, քանի դեռ այն ակտիվ է։ Եթե օգտատերը չեղարկի կամ վերաստեղծի բանալին, թարմացումը կձախողվի invalid_grant-ով, իսկ API կանչերը կվերադարձնեն 401՝ սկսեք կրկնակի վավերացում։
• Հարցումները սահմանափակված են արագությամբ ըստ IP-ի և օրական սահմանաչափով՝ ըստ հաճախորդի. սխալները հետևում են RFC 6749-ին (error, error_description)։
• Յուրաքանչյուր օգտատեր ստանում է առավելագույնը իր սեփական երկրների սահմանաչափը. եթե ինտեգրումն ավելի շատ երկիր ունի, քան օգտատիրոջ ազատ տեղերը, նա ընտրում է դրանք համաձայնության էջում (նախնական ընտրության համար /oauth/authorize-ին փոխանցեք markets=DE,AT)։ Token-ի երկու պատասխաններն էլ վերադարձնում են markets_approved (օգտատիրոջ հաստատված երկրները), markets_allowed (նրա սահմանաչափը. null = անսահմանափակ), markets_available (ձեր երկրները, որոնք նա դեռ չունի) և upgrade_url (որտեղ ավելացնել «Լրացուցիչ երկրներ»)։

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-ը LocalOAuth2ImplementationWithPkce-ի հետ (client_secret դատարկ) և վերաուղղորդման URI https://my.home-assistant.io/redirect/oauth, որը նախապես գրանցված է Home Assistant հաճախորդների համար։ Կարդացեք բանալին entry.data["token"]["access_token"]-ից և շարունակեք կանչել API-ն Authorization: Bearer-ով։ API-ից 401 ստանալիս բարձրացրեք ConfigEntryAuthFailed, որպեսզի Home Assistant-ը առաջարկի կրկնակի վավերացում։

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)

Ինտեգրումներ՝ ցույց տվեք մնացած սահմանաչափերը

GET /api/v2/account/usage — Որքան է մնացել ձեր սահմանաչափերից հենց հիմա այն բանալու համար, որով կանչում եք՝ պլան, վայրկյանային սահմանաչափ և օրական քվոտայի յուրաքանչյուր դասի (cheap, heavy, route) համար սահմանաչափ, օգտագործված, մնացորդ և զրոյացման ժամ (կեսգիշեր UTC), ինչպես նաև ձեր երկրները այնպես, ինչպես տեսնում է այս բանալին, և որտեղ բարելավել պլանը։ Չի հաշվարկվում, 30 կանչ րոպեում՝ մեկ բանալու համար։

Ինտեգրման (OAuth) բանալիները միշտ կարող են կանչել GET /api/v2/account/usage՝ անկախ նրանից, թե ինչ արտադրանքներ է թույլատրում ինտեգրումը։ Թվերը համընկնում են X-Devapi-Limit և X-Devapi-Remaining վերնագրերի հետ, իսկ X-Devapi-Reset-ը տալիս է զրոյացման ժամը Unix timestamp-ով։

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

Երբ սահմանաչափը սպառվում է, սխալը ցույց է տալիս, թե ուր գնալ. 429 quota_exceeded-ը վերադարձնում է նաև error.reset_at (կեսգիշեր UTC) և error.upgrade_url. 403 market_not_allowed-ը և 403 integration_product_not_allowed-ը վերադարձնում են error.upgrade_url։ Ինտեգրացիայի բանալիները ստանում են նաև error.pass_url (Trip Pass, ստորև)։

Home Assistant՝ հարցրեք /account/usage-ը ոչ ավելի հաճախ, քան 15 րոպեն մեկ, և ցուցադրեք «մնացած կանչեր» սենսոր quotas.cheap.remaining-ից։ Հարցումների միջև կարդացեք X-Devapi-Remaining-ը սովորական կանչերից։ 429 quota_exceeded կամ 403 market_not_allowed դեպքում ստեղծեք repair issue՝ error.upgrade_url հղումով, և դադարեցրեք կանչերը մինչև reset_at։

Trip Pass

Ինտեգրացիաների օգտատերերը կարող են Վճարումների էջում գնել Trip Pass (1, 3, 7 կամ 14 օր, միանվագ վճարում)։ Քանի դեռ այն գործում է, ինտեգրացիայի բանալին ստանում է ինտեգրացիայի բոլոր երկրները, օրական ավելի շատ բեռնատարի երթուղու և տվյալների հարցումներ և ավելի բարձր հաճախականություն. ինտեգրացիայի արտադրանքները, կանխատեսումների սահմանաչափերը և տվյալների ուշացումը չեն փոխվում։ Նույն հաշվի մշակողի բանալիները երբեք չեն բարձրացվում։

Ինտեգրացիայի բանալիների համար account/usage-ը վերադարձնում է pass. {active, expires_at, days_left} և pass_url (Վճարումների էջի Trip Pass բաժինը). 429 quota_exceeded-ը և 403 market_not_allowed / integration_product_not_allowed-ը պարունակում են նույն error.pass_url-ը։ Այլ բանալիների համար երկուսն էլ null են։

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.

Vehicle types (crossing_type)

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.

Պրոդուկտներ

Ընտրեք 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>, որը Google-ը կարող է ինդեքսավորել և հետևել դրան, — ՄԻ ավելացրեք rel="nofollow", rel="sponsored" կամ rel="ugc" և մի թաքցրեք այն CSS-ով։ JavaScript-ով ավելացված հղումն ընդունելի է, եթե այն երևում է Google-ի ռենդերած էջում (Developer API-ի պայմաններ v1.0, բաժին 8.1)։

<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-ին ուղղված ցանկացած տեսանելի սովորական HTML հղում: Խարիսխի տեքստը՝ "Data by nakordoni.eu", պետք է մնա անգլերեն:

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

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

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

Ստուգումներն իրականացվում են մոտավորապես շաբաթը մեկ անգամ մեր ստուգիչի կողմից, որի user agent-ը պարունակում է NakordoniComplianceBot/1.0։ Այն բացում է միայն ձեր մշակողի վահանակում նշված էջերը, չի անցնում այլ հղումներով և այդ էջերի համար հաշվի չի առնում robots.txt-ը, քանի որ հենց դրանք եք խնդրել ստուգել։ Եթե բոտերից պաշտպանությունը կամ ֆայրվոլն արգելափակում է անհայտ քրաուլերներին, թույլատրեք այս user agent-ը․ եթե չկարողանանք բացել էջը, կգրենք ձեզ տոմսով։

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

Ձեր API բանալին տալիս է մեր տվյալների օգտագործման լիցենզիա միայն այն երկրներում, որոնք դուք հայտարարել եք գրանցվելիս։ Մենք ուսումնասիրում ենք յուրաքանչյուր հայտարարություն լիարժեք հասանելիություն տրամադրելուց առաջ, քանի որ մեր տվյալները մեր սեփական արտադրանքն են, և մենք չենք լիցենզավորում այն շուկաներում՝ չիմանալով, թե որտեղ կհրապարակվի։

• Հայտարարեք ձեր կայքի, հավելվածի կամ արտադրանքի ծառայող յուրաքանչյուր երկիր։ Ցանկը կարող եք փոփոխել ցանկացած պահի ձեր վահանակից. փոփոխությունը ձեր հաշիվը կրկին վերանայման է դնում։
• Մինչ ձեր շուկաների հաստատումը՝ ձեր բանալին աշխատում է կրճատված սահմանաչափերով՝ Starter պլանի սահմանաչափի կեսով։ Սա կիրառվում է անկախ նրանից, թե որ պլանում եք գտնվում։
• Մենք կարող ենք հաստատել միայն այն երկրներից մի քանիսը, որոնք դուք խնդրել եք։ հաստատված ցանկը, ոչ թե խնդրածը, որոշում է, թե cuales países cubre su licencia.
• Չհայտարարված շուկայում մեր տվյալները հրապարակելը կամ վերաբաշխելը, կամ դրանք որպես մրցակցող տվյալների հոսք վերավաճառելը, խախտում է այս պայմանները և կարող է առանց ծանուցման կասեցնել ձեր բանալին։
• Որոշ պլաններ առաջարկվում են միայն ընտրված տարածաշրջաններում։ Հասանելիությունը կախված է ձեր հայտարարած շուկաներից։
• Ամբողջական համաձայնագիրը Developer API-ի պայմանները է: Այն գերակայում է այս ամփոփման նկատմամբ. իրավական ուժ ունի անգլերեն տարբերակը:

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

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

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

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

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

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