API Kalendari Festivaleve Online
Pushimet zyrtare publike sipas vendit evropian — data, emrat lokal dhe lloji, përfshirë listën e plotë të pushimeve për secilin vend. Mbështetur nga i njëjti shërbim Nager.Date / OpenHolidaysAPI (cache 7-ditore, kalendari Kosovës i llogaritur lokalisht) që fuqizon faqen e kalendarit të pushimeve nakordoni.eu dhe faktorët kalendarikë të sistemit të parashikimit. Një vend kthen një objekt të sheshtë; disa vende kthehen të njëjtën formë të mbështjellë në një listë. upcoming=1 kalon në një feed të sheshtë të renditur sipas datës ndërmjet vendeve; compare_to kalon në një krahasim identik-vs-ndryshëm ndërmjet vendeve, i dobishëm për të kontrolluar nëse një datë është pushim në të dyja anët e kalimit kufitar ose vetëm në njërën.
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. |
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.countries | The countries compared — the one you asked about and compare_to. |
data.same[] | Days that are a public holiday in BOTH countries: date, weekday, names (one per country). |
data.different[] | Days that are a holiday in one country only: date, weekday, in (where it applies), not_in, names. These are the border-traffic days that catch drivers out. |
data.same_count | Size of same, with different_count for different. |
data.window | Period covered, inside data.year. |
data.mode | Single-country listing or two-country comparison. |
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"