Kalendár sviatkov — API sviatkov Online
Štátne, bankové, regionálne, náboženské a pamätné sviatky pre 51 krajín (Európa + Perzský záliv) a ich regióny, 2020-2035, z nášho vlastného enginu pravidiel sviatkov. Každý sviatok uvádza, či je voľným dňom, bankovým sviatkom alebo či spadá do školských prázdnin, či sa sviatok vo víkende presunul na iný deň, či je jeho dátum stále odhadovaný (islamský kalendár) a či v daný deň platí zákaz jazdy nákladných vozidiel a kedy. Zahŕňa pravidlo vojnového stavu na Ukrajine (sviatky sú uvedené, nie sú voľnými dňami) a presuny dní na základe nariadenia (transfers[]). Až 10 krajín na jedno volanie; rok alebo ľubovoľný rozsah do 731 dní.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
country | Dvojznakový kód krajiny ISO alebo zoznam až 10 kódov oddelených čiarkou (povinné), napr. DE alebo DE,PL,UA |
year | YYYY, 2020-2035 (predvolené: aktuálny rok). Ignoruje sa, ak sa pošle from/to |
from | Začiatok rozsahu YYYY-MM-DD (s to; najviac 731 dní) |
to | Koniec rozsahu YYYY-MM-DD |
region | Región ISO 3166-2, napr. DE-BY (alebo BY pri jednej krajine): štátne sviatky + iba sviatky daného regiónu. Vynechajte pre všetky regióny |
type | Filter oddelený čiarkami: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, alebo all. Predvolené: všetko okrem BRIDGE |
lang | Kódy jazykov oddelené čiarkami pre name.translations (predvolené: všetky jazyky, ktoré evidujeme), napr. en,uk,pl |
q | Vyhľadávanie v názvoch sviatkov (v ľubovoľnom jazyku), napr. christmas |
id | Jeden sviatok podľa ID (ostatné filtre sa ignorujú) |
school | 1 = zobraziť aj obdobia školských prázdnin (school_holidays[]) pre krajiny, ktoré ich zverejňujú |
include | impact = pridá business_intelligence ku každému sviatku (Pro a vyššie) |
min_impact | Iba sviatky s impact_score najmenej touto hodnotou (0-100); implikuje include=impact |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
data.holidays[].id | Stabilné ID sviatku, napr. hol_de_christmas_day_2026 — hodnota, ktorú prijíma ?id=. Náhradné (presunuté) dni končia na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=pondelok..7=nedeľa), day_name, is_weekend (víkend danej krajiny). |
data.holidays[].name | en, local (v local_lang) a translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL alebo 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čítaný dátum podľa islamského kalendára), note (suspended_martial_law, transferred_by_decree alebo null). |
data.holidays[].floating_logic | is_floating, rule (pravidlo dátumu v bežnom jazyku), shifted_from (pôvodný dátum, keď sa sviatok vo víkende presunul). |
data.holidays[].truck_ban | Sviatočný zákaz jazdy nákladných vozidiel v danej krajine: applies, time_from, time_until (miestny čas), min_weight_tons, eve_rule {date,time_from,time_until} pre zákaz v predvečer sviatku, scope_note. |
data.holidays[].business_intelligence | S include=impact v pláne Pro a vyššom: ten istý modelom odhadnutý blok, ktorý vracia produkt impact. |
data.transfers[] | Presuny dní na základe nariadenia v danom 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átených sviatkov; countries a window {from,to} opakujú hodnoty z požiadavky. |
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"
Aktualizované