Ημερολόγιο αργιών — API επιχειρησιακού αντίκτυπου Online
Εκτιμώμενος από μοντέλο επιχειρησιακός αντίκτυπος των αργιών για λιανική, logistics και προγραμματισμό ζήτησης (Pro και ανώτερα). Το insights βαθμολογεί κάθε αργία από 0 έως 100 με την πιθανότητα κλειστών καταστημάτων, τις κατηγορίες ζήτησης που αυξάνονται πριν από αυτήν, τη θέση σε long weekend και γέφυρα και τον πολλαπλασιαστή κίνησης στα σύνορα, καθώς και σύνοψη ανά χώρα. Το 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 | Σταθερό αναγνωριστικό αργίας, π.χ. 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 | Αναγνωριστικό μοντέλου και σημείωση ότι πρόκειται για εκτιμήσεις. |
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"
Ενημερώθηκε