დღესასწაულების კალენდარი — ბიზნესზე ზეგავლენის API Online
დღესასწაულების მოდელით შეფასებული ზეგავლენა ბიზნესზე საცალო ვაჭრობის, ლოგისტიკისა და მოთხოვნის დაგეგმვისთვის (Pro და უფრო მაღალი). insights თითოეულ დღესასწაულს აფასებს 0-100 შკალით და აჩვენებს მაღაზიების დახურვის ალბათობას, მის წინ მზარდი მოთხოვნის კატეგორიებს, გრძელი შაბათ-კვირისა და ხიდის პოზიციას და ჩვენს სასაზღვრო ტრაფიკის მულტიპლიკატორს, ასევე თითო ქვეყნის შეჯამებას. demand-surge აბრუნებს უქმე დღესასწაულების გარშემო დათარიღებულ ფანჯრებს (დღესასწაულამდე, დღესასწაული, დღესასწაულის შემდეგ), თითოეულს ინტენსივობით. ქულები არის შეფასებები, რომლებიც ეფუძნება დღესასწაულის ტიპს, უქმე დღის სტატუსს, მოქმედების არეალს, კალენდარში პოზიციას, სატვირთო მანქანების აკრძალვებს და ჩვენს ტრაფიკის მულტიპლიკატორებს — და არა დაკვირვებულ გაყიდვების მონაცემებს.
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 | დღესასწაულის სტაბილური 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"
განახლდა