Мереке күнтізбесі — Бизнеске әсер 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 | Тұрақты мереке идентификаторы, мысалы 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"
Жаңартылды