Kalendari i festave — API i festave Online
Festa publike, bankare, rajonale, fetare dhe përkujtimore për 51 vende (Evropë + Gjiri) dhe rajonet e tyre, 2020-2035, nga motori ynë i rregullave të festave. Çdo festë tregon nëse është ditë pushimi, festë bankare apo brenda pushimeve shkollore, nëse një festë që bie në fundjavë është zhvendosur në një ditë tjetër, nëse data e saj është ende e vlerësuar (kalendari islamik), dhe nëse atë ditë zbatohet ndalim i qarkullimit të kamionëve dhe kur. Mbulon rregullin e ligjit ushtarak të Ukrainës (festat listohen, nuk janë ditë pushimi) dhe zhvendosjet e ditëve me dekret (transfers[]). Deri në 10 vende për thirrje; një vit ose çdo interval deri në 731 ditë.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
country | Kodi ISO-2 i vendit, ose listë e ndarë me presje deri në 10 (e detyrueshme), p.sh. DE ose DE,PL,UA |
year | YYYY, 2020-2035 (parazgjedhja: viti aktual). Shpërfillet kur dërgohet from/to |
from | Fillimi i intervalit YYYY-MM-DD (me to; maksimumi 731 ditë) |
to | Fundi i intervalit YYYY-MM-DD |
region | Rajoni ISO 3166-2, p.sh. DE-BY (ose BY me një vend): festat kombëtare + vetëm ato të këtij rajoni. Lëreni bosh për çdo rajon |
type | Filtër i ndarë me presje: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, ose all. Parazgjedhja: gjithçka përveç BRIDGE |
lang | Kode gjuhësh të ndara me presje për name.translations (parazgjedhja: çdo gjuhë që disponojmë), p.sh. en,uk,pl |
q | Kërkim në emrat e festave (në çdo gjuhë), p.sh. christmas |
id | Një festë sipas id-së (filtrat e tjerë shpërfillen) |
school | 1 = liston edhe periudhat e pushimeve shkollore (school_holidays[]) për vendet që i publikojnë |
include | impact = shton business_intelligence te çdo festë (Pro e lart) |
min_impact | Vetëm festat me impact_score të paktën kaq (0-100); nënkupton include=impact |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.holidays[].id | ID e qëndrueshme e festës, p.sh. hol_de_christmas_day_2026 — vlera që pranon ?id=. Ditët e vëzhguara (të zhvendosura) mbarojnë me _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=e hënë..7=e diel), day_name, is_weekend (fundjava e vendit). |
data.holidays[].name | en, local (në local_lang) dhe translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL ose REGIONAL, regions_affected (kode ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (datë e llogaritur sipas kalendarit islamik), note (suspended_martial_law, transferred_by_decree ose null). |
data.holidays[].floating_logic | is_floating, rule (rregulli i datës në gjuhë të thjeshtë), shifted_from (data origjinale kur një festë e fundjavës është zhvendosur). |
data.holidays[].truck_ban | Ndalimi i qarkullimit të kamionëve në festë në atë vend: applies, time_from, time_until (ora lokale), min_weight_tons, eve_rule {date,time_from,time_until} për ndalim në prag të festës, scope_note. |
data.holidays[].business_intelligence | Me include=impact në planin Pro e lart: i njëjti bllok i vlerësuar nga modeli që kthen produkti i ndikimit. |
data.transfers[] | Zhvendosjet e ditëve me dekret në dritare: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Me school=1: id, start_date, end_date, name, location. |
data.count | Festat e kthyera; countries dhe window {from,to} pasqyrojnë kërkesën. |
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"
Përditësuar