Docs · Use cases
API & Widget për Bizneset
Integrim falas i kalendarit zyrtar të festave të Shqipërisë dhe Kosovës — API JSON, feed iCal, widget JavaScript me një rresht. Pa kartë krediti, pa kosto fillimi.
Çfarë mund të ndërtosh
Sisteme HR / Paga
Problemi: Kompania jote duhet të llogarisë automatikisht ditët e punës dhe pushimet zyrtare për Shqipërinë dhe Kosovën, duke marrë parasysh edhe zhvendosjen e festave që bien në fundjavë.
Zgjidhja: Merr listën e plotë të festave për një vit me një kërkesë GET. Përgjigja përfshin datën origjinale dhe datën e zhvendosur (observed) për çdo festë.
/api/v1/{account_id}/al/holidays/2026Banka / Telekom
Problemi: Klientët shohin njoftime për kohën e shërbimit dhe ditët kur degat janë mbyllur. Duhet një burim i besueshëm dhe i azhurnuar i festave zyrtare.
Zgjidhja: Përdor endpoint-in 'today' për të kontrolluar nëse sot është festë, ose 'next' për festën tjetër në horizont. Të dyja janë rate-limited dhe të çuara nga e njëjta databazë që ushqen kalendarfestash.com.
/api/v1/{account_id}/al/todaySoftware kontabiliteti
Problemi: Faturimi automatik duhet të shmangë dërgimin në datat zyrtare të pushimit dhe të llogarisë saktë afatet kontraktuale.
Zgjidhja: Tërhiq festat e vitit të ardhshëm një herë në muaj, ruaji në databazën tënde, përdori për validim afatesh. API-ja jonë mbulon vitet 2024–2035 për të dyja shtetet.
/api/v1/{account_id}/ks/holidays/2026Aplikacione kalendari / produktiviteti
Problemi: Përdoruesit duan të shohin festat zyrtare drejtpërdrejt në Google Calendar, Outlook ose Apple Calendar pa importuar manualisht.
Zgjidhja: Përdor feed-in iCal — abonohu një herë dhe çdo përditësim mbërrin automatikisht. Ofrohet për të dyja shtetet, përfshin festën origjinale dhe datën e zhvendosur.
/api/v1/{account_id}/al/holidays/2026/icalFaqe interneti / portale lajmesh
Problemi: Dëshiron të shfaqësh festat e ardhshme në sidebar pa shkruar kod, pa mirëmbajtur të dhëna, pa thirrur API-në vetë.
Zgjidhja: Vendos widget-in tonë me një rresht JavaScript. Renderon 5 festat e ardhshme automatikisht, përditësohet vetë, përshtatet me dark mode. Falas, përfshin një backlink të vogël te kalendarfestash.com.
(Shih më poshtë — Widget i Embed)E-commerce
Problemi: Dyqani online duhet të planifikojë fushatat dhe të ndryshojë afatet e dërgimit gjatë periudhave të festave (Bajram, Pashkë, 28 Nëntor, Krishtlindje).
Zgjidhja: Sinkronizo kalendarin tonë me sistemin tënd CMS ose ERP. Endpoint-i 'long-weekends' tregon edhe fundjavat e gjata, që janë periudhat me konvertim më të lartë për ofertat sezonale.
/api/v1/{account_id}/al/long-weekends/2026Widget — një rresht JavaScript
Mënyra më e shpejtë për të shfaqur festat e ardhshme në çdo faqe interneti. Renderon 5 festa, përshtat dark mode automatikisht, përditësohet vetë çdo orë.
<!-- Vendos diku në faqen tënde: -->
<div id="kalendarfestash-widget"
data-country="al"
data-count="5"></div>
<!-- Pranë </body>: -->
<script src="https://kalendarfestash.com/widget/holidays.js"
defer></script>Atribute
data-country:aloseksdata-count: 1–10 (default 5)
Detaje
- Pa varësi të jashtme
- ~3 KB i komprimuar
- Përfshin link “Powered by”
Pyetje ose volum të mëdha?
Për integrime të personalizuara, SLA ose bashkëpunime brand, na kontakto te faqja e partnerëve.