API Kalendari Festivaleve Online
Official public holidays per European country — dates, local names and type, each country's full holiday list included. Backed by the same Nager.Date / OpenHolidaysAPI service (7-day cache, locally-computed Kosovo calendar) that powers the nakordoni.eu holiday calendar page and the prediction system's calendar factors. One country returns a flat object; several return the same shape wrapped in a list. upcoming=1 switches to a flat, date-sorted cross-country feed; compare_to switches to a same-vs-different comparison across countries, useful for checking whether a date is a holiday on both sides of a border crossing or just one.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
country | Kodi ISO-2 i vendit ose një listë me deri në 15 koda të ndara me presje, p.sh. PL ose PL,DE,UA. Lëreni bosh për grupin default (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Një kod kthen një objekt të thjeshtë; disa koda kthejnë një listë. |
compare_to | Kodi ISO-2 i vendit ose listë e ndarë me presje për krahasim. Kalon në modalitetin e krahasimit: kthen cilat datat e festave janë të përbashkëta PËR TË GJITHA vendet e zgjedhura (të njëjta) dhe cilat vetëm për disa (të ndryshme, me lista të veçanta brenda/jashtë për çdo datë). Parametrat upcoming dhe days bashkëpunojnë me këtë — ngushtojnë të njëjtat/të ndryshmet në dritaren e datave të zgjedhura në vend të gjithë vitit. |
year | YYYY (paraprak: viti aktual) |
upcoming | 1 = listë e sheshtë e festave të ardhshme sipas vendeve për disa ditë (opsional) |
days | Horizonte në ditë për modalitetin "të ardhshëm", 1-180. Injorimi ose 0 do të thotë pa kufizim — gjithçka që shërbimi nënkuptuar mund të shohë, këtë vit dhe vitin e ardhshëm. |
lang | Gjuha(et) për fushën e emrit të lokalizuar (parazgjedhje en), si në faqen e kalendarit të festave të nakordoni.eu me 24 gjuhë. Për të dhënat jo në cache përdoret emri vendor ose anglisht. Lista e ndarë me presje, deri në 10 gjuhë, p.sh. lang=en,uk,pl — emri merret nga gjuha e parë e kërkuar; çdo festë ka gjithashtu një objekt names me çelësat sipas kodit të gjuhës që përmban të gjitha përkthimet. |
curl "https://nakordoni.eu/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Hyni