Տոնացույց — Business Impact API Online
Տոների մոդելային գնահատված ազդեցությունը բիզնեսի վրա մանրածախ առևտրի, լոգիստիկայի և պահանջարկի պլանավորման համար (Pro և ավելի բարձր)։ insights-ը գնահատում է յուրաքանչյուր տոն 0-100 սանդղակով՝ խանութների փակ լինելու հավանականությամբ, տոնից առաջ աճող պահանջարկի կատեգորիաներով, երկար հանգստյան օրերի և կամրջի դիրքով և մեր սահմանային երթևեկության գործակցով, ինչպես նաև ամփոփմամբ ըստ երկրի։ demand-surge-ը վերադարձնում է հանգստյան օր հանդիսացող տոների շուրջ ամսաթվերով պատուհանները (pre-holiday, holiday, post-holiday)՝ յուրաքանչյուրի ինտենսիվությամբ։ Գնահատականները հիմնված են տոնի տեսակի, հանգստյան օրվա կարգավիճակի, ընդգրկման, օրացույցային դիրքի, բեռնատարների արգելքների և մեր երթևեկության գործակիցների վրա՝ դրանք դիտարկված վաճառքի տվյալներ չեն։
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— քվոտայի դաս: heavy
| Պարամետր | Նկարագրություն |
|---|---|
op | insights (լռելյայն) | demand-surge |
country | ISO-2 երկրի կոդ կամ մինչև 10 կոդերի ստորակետով ցանկ (պարտադիր) |
year | YYYY, 2020-2035 (լռելյայն՝ ընթացիկ տարին) |
from | Միջակայքի սկիզբ YYYY-MM-DD (to-ի հետ. առավելագույնը 731 օր) |
to | Միջակայքի ավարտ YYYY-MM-DD |
region | ISO 3166-2 տարածաշրջան, օր.՝ DE-BY (ըստ ցանկության) |
lang | Լեզվի կոդեր անունների համար (լռելյայն՝ բոլոր ունեցածները) |
min_impact | Միայն այն տոները, որոնց impact_score-ը առնվազն այսքան է (0-100) |
Պատասխանի դաշտերը — պատասխանի ծրարի data օբյեկտի ներսում։ []-ը ցույց է տալիս ցուցակ, ուստի data.items[].name-ը յուրաքանչյուր տարրի name դաշտն է։ Դաշտը լինում է null, բացակայում է կամ դատարկ ցուցակ է, երբ արժեք չունենք․ լցոնող արժեք երբեք չենք դնում։
| Դաշտ | Նկարագրություն |
|---|---|
data.holidays[].id | Տոնի կայուն նույնացուցիչ, օր.՝ hol_de_christmas_day_2026 — ?id= պարամետրի ընդունած արժեքը։ Դիտարկվող (տեղափոխված) օրերը ավարտվում են _obs-ով։ |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Երկուշաբթի..7=Կիրակի), day_name, is_weekend (երկրի հանգստյան օրեր)։ |
data.holidays[].name | en, local (local_lang լեզվով) և translations {lang: name}։ |
data.holidays[].location | country_code, scope NATIONAL կամ REGIONAL, regions_affected (ISO 3166-2 կոդեր)։ |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (հաշվարկված իսլամական օրացույցի ամսաթիվ), note (suspended_martial_law, transferred_by_decree կամ null)։ |
data.holidays[].floating_logic | is_floating, rule (ամսաթվի կանոնը պարզ լեզվով), shifted_from (սկզբնական ամսաթիվը, երբ հանգստյան օրվան ընկած տոնը տեղափոխվել է)։ |
data.holidays[].truck_ban | Տոնական բեռնատարների երթևեկության արգելք տվյալ երկրում՝ applies, time_from, time_until (տեղական ժամանակով), min_weight_tons, eve_rule {date,time_from,time_until} նախորդ օրվա արգելքի համար, scope_note։ |
data.holidays[].business_intelligence | impact_score 0-100, retail_closure_probability 0-1, demand_surge_categories[], long_weekend, bridge_opportunity, holiday_family, border_traffic_multiplier (null, երբ չկա), basis model_estimated, model։ |
data.summary[] | op=insights, ըստ երկրի՝ holidays, weekday_days_off, long_weekends, average_impact_score, top_holidays[3]։ |
data.windows[] | op=demand-surge՝ date, phase (pre_holiday | holiday | post_holiday), intensity 0-100, demand_surge_categories, retail_closure_probability (holiday փուլ), holiday_id, holiday_name, country_code, regions_affected։ |
data.impact_model | Մոդելի id-ն և նշումն այն մասին, որ դրանք գնահատականներ են։ |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/impact?op=insights&country=DE,PL&year=2026" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Թարմացվել է