Kalendář svátků — API svátků Online
Státní, bankovní, regionální, náboženské a pamětní svátky pro 51 zemí (Evropa + Perský záliv) a jejich regiony, 2020-2035, z našeho vlastního enginu pravidel svátků. Každý svátek uvádí, zda je dnem volna, bankovním svátkem nebo zda spadá do školních prázdnin, zda se svátek o víkendu přesunul na jiný den, zda je jeho datum stále odhadované (islámský kalendář) a zda se v daný den uplatňuje zákaz jízdy nákladních vozidel a kdy. Zahrnuje pravidlo válečného stavu na Ukrajině (svátky jsou uvedeny, nejsou dny volna) a přesuny dnů na základě nařízení (transfers[]). Až 10 zemí na jedno volání; rok nebo libovolný rozsah do 731 dnů.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
country | Dvouznakový kód země ISO nebo seznam až 10 kódů oddělených čárkou (povinné), např. DE nebo DE,PL,UA |
year | YYYY, 2020-2035 (výchozí: aktuální rok). Ignoruje se, pokud je odesláno from/to |
from | Začátek rozsahu YYYY-MM-DD (s to; nejvýše 731 dnů) |
to | Konec rozsahu YYYY-MM-DD |
region | Region ISO 3166-2, např. DE-BY (nebo BY u jedné země): státní svátky + pouze svátky daného regionu. Vynechte pro všechny regiony |
type | Filtr oddělený čárkami: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, nebo all. Výchozí: vše kromě BRIDGE |
lang | Kódy jazyků oddělené čárkami pro name.translations (výchozí: všechny jazyky, které evidujeme), např. en,uk,pl |
q | Vyhledávání v názvech svátků (v libovolném jazyce), např. christmas |
id | Jeden svátek podle ID (ostatní filtry se ignorují) |
school | 1 = zobrazit také období školních prázdnin (school_holidays[]) pro země, které je zveřejňují |
include | impact = přidá business_intelligence ke každému svátku (Pro a vyšší) |
min_impact | Pouze svátky s impact_score alespoň této hodnoty (0-100); implikuje include=impact |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
data.holidays[].id | Stabilní ID svátku, např. hol_de_christmas_day_2026 — hodnota, kterou přijímá ?id=. Náhradní (přesunuté) dny končí na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=pondělí..7=neděle), day_name, is_weekend (víkend dané země). |
data.holidays[].name | en, local (v local_lang) a translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL nebo REGIONAL, regions_affected (kódy ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (vypočtené datum podle islámského kalendáře), note (suspended_martial_law, transferred_by_decree nebo null). |
data.holidays[].floating_logic | is_floating, rule (pravidlo data v běžném jazyce), shifted_from (původní datum, když se svátek o víkendu přesunul). |
data.holidays[].truck_ban | Svátkový zákaz jízdy nákladních vozidel v dané zemi: applies, time_from, time_until (místní čas), min_weight_tons, eve_rule {date,time_from,time_until} pro zákaz v předvečer svátku, scope_note. |
data.holidays[].business_intelligence | S include=impact v plánu Pro a vyšším: stejný modelem odhadnutý blok, který vrací produkt impact. |
data.transfers[] | Přesuny dnů na základě nařízení v daném období: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | S school=1: id, start_date, end_date, name, location. |
data.count | Počet vrácených svátků; countries a window {from,to} opakují hodnoty z požadavku. |
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"
Aktualizováno