Календар празника — API за празнике Online
Државни, банкарски, регионални, верски празници и дани обележавања за 51 државу (Европа + Залив) и њихове регионе, 2020-2035, из нашег сопственог механизма правила за празнике. Сваки празник садржи податак да ли је нерадни дан, банкарски празник или се налази унутар школског распуста, да ли је празник који пада на викенд премештен на други дан, да ли је његов датум још увек процењен (исламски календар) и да ли тог дана важи забрана саобраћаја за камионе и када. Обухвата правило ратног стања у Украјини (празници су наведени, али нису нерадни дани) и премештање дана одлуком (transfers[]). До 10 држава по позиву; једна година или било који опсег до 731 дана.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— класа квоте: cheap
| Параметар | Опис |
|---|---|
country | ISO-2 код државе или листа до 10 кодова раздвојених зарезима (обавезно), нпр. DE или DE,PL,UA |
year | YYYY, 2020-2035 (подразумевано: текућа година). Занемарује се када се пошаље from/to |
from | Почетак опсега YYYY-MM-DD (са to; највише 731 дан) |
to | Крај опсега YYYY-MM-DD |
region | ISO 3166-2 регион, нпр. DE-BY (или BY уз једну државу): државни празници + само празници тог региона. Изоставите за све регионе |
type | Филтер раздвојен зарезима: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE или all. Подразумевано: све осим BRIDGE |
lang | Кодови језика раздвојени зарезима за name.translations (подразумевано: сви језици којима располажемо), нпр. en,uk,pl |
q | Претрага по називима празника (на било ком језику), нпр. christmas |
id | Један празник по идентификатору id (остали филтери се занемарују) |
school | 1 = додатно наводи периоде школског распуста (school_holidays[]) за државе које их објављују |
include | impact = додаје business_intelligence сваком празнику (Pro и виши) |
min_impact | Само празници са impact_score најмање једнаким овој вредности (0-100); подразумева include=impact |
Поља одговора — унутар објекта 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 | Са include=impact на плану Pro и вишим: исти блок процене модела који враћа производ impact. |
data.transfers[] | Премештања дана одлуком у задатом периоду: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Са school=1: id, start_date, end_date, name, location. |
data.count | Број враћених празника; countries и window {from,to} понављају захтев. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Ažurirano