Calendar de sărbători — API Sărbători Online
Sărbători legale, bancare, regionale, religioase și zile comemorative pentru 51 de țări (Europa + Golf) și regiunile lor, 2020-2035, generate de propriul nostru motor de reguli pentru sărbători. Fiecare sărbătoare indică dacă este zi liberă, sărbătoare bancară sau se încadrează în vacanțele școlare, dacă o sărbătoare căzută în weekend a fost mutată în altă zi, dacă data ei este încă estimată (calendar islamic) și dacă în acea zi se aplică o interdicție de circulație pentru camioane și în ce interval. Include regula legii marțiale din Ucraina (sărbători listate, dar nu zile libere) și transferurile de zile prin decret (transfers[]). Până la 10 țări per apel; un an sau orice interval de până la 731 de zile.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
country | Cod de țară ISO-2 sau listă separată prin virgulă de până la 10 (obligatoriu), de ex. DE sau DE,PL,UA |
year | YYYY, 2020-2035 (implicit: anul curent). Ignorat când se trimite from/to |
from | Începutul intervalului YYYY-MM-DD (împreună cu to; cel mult 731 de zile) |
to | Sfârșitul intervalului YYYY-MM-DD |
region | Regiune ISO 3166-2, de ex. DE-BY (sau BY cu o singură țară): sărbătorile naționale + doar cele ale acelei regiuni. Omiteți pentru toate regiunile |
type | Filtru separat prin virgulă: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE sau all. Implicit: tot, cu excepția BRIDGE |
lang | Coduri de limbă separate prin virgulă pentru name.translations (implicit: toate limbile disponibile), de ex. en,uk,pl |
q | Căutare în denumirile sărbătorilor (în orice limbă), de ex. christmas |
id | O sărbătoare după id (celelalte filtre sunt ignorate) |
school | 1 = listează și perioadele de vacanță școlară (school_holidays[]) pentru țările care le publică |
include | impact = adaugă business_intelligence la fiecare sărbătoare (Pro sau superior) |
min_impact | Doar sărbători cu un impact_score de cel puțin această valoare (0-100); implică include=impact |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.holidays[].id | ID stabil al sărbătorii, de ex. hol_de_christmas_day_2026 — valoarea acceptată de ?id=. Zilele observate (mutate) se termină cu _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=luni..7=duminică), day_name, is_weekend (weekendul țării). |
data.holidays[].name | en, local (în local_lang) și translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL sau REGIONAL, regions_affected (coduri ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (dată calculată după calendarul islamic), note (suspended_martial_law, transferred_by_decree sau null). |
data.holidays[].floating_logic | is_floating, rule (regula datei în limbaj simplu), shifted_from (data originală când o sărbătoare din weekend a fost mutată). |
data.holidays[].truck_ban | Interdicție de circulație pentru camioane în sărbători în țara respectivă: applies, time_from, time_until (ora locală), min_weight_tons, eve_rule {date,time_from,time_until} pentru o interdicție în ajun, scope_note. |
data.holidays[].business_intelligence | Cu include=impact în planul Pro sau superior: același bloc estimat de model pe care îl returnează produsul de impact. |
data.transfers[] | Transferuri de zile prin decret în interval: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Cu school=1: id, start_date, end_date, name, location. |
data.count | Sărbători returnate; countries și window {from,to} reflectă cererea. |
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"
Actualizat