REST API
API za slovenske praznike
Brezplačen JSON API za pridobivanje slovenskih praznikov, dela prostih dni in spominskih dni. Idealen za integracijo v vaše aplikacije.
Osnovni URL
https://koledarko.si/api
Končne točke
GET
/api/holidaysPridobi vse praznike za določeno leto
Parametri
| Parameter | Tip | Obvezen | Opis |
|---|---|---|---|
| year | number | Da | Leto (npr. 2026) |
| country | string | Ne | Država (privzeto: SI) |
Primer zahteve
GET https://koledarko.si/api/holidays?year=2026&country=SI
Primer odgovora
{
"success": true,
"data": [
{
"date": "2026-01-01",
"name": "Novo leto",
"isWorkFree": true,
"type": "praznik"
},
{
"date": "2026-02-08",
"name": "Prešernov dan",
"isWorkFree": true,
"type": "praznik",
"description": "Dan smrti pesnika Franceta Prešerna"
}
]
}GET
/api/holidaysPridobi praznike za določen mesec
Parametri
| Parameter | Tip | Obvezen | Opis |
|---|---|---|---|
| year | number | Da | Leto (npr. 2026) |
| month | number | Da | Mesec (1-12) |
| country | string | Ne | Država (privzeto: SI) |
Primer zahteve
GET https://koledarko.si/api/holidays?year=2026&month=12&country=SI
Primer odgovora
{
"success": true,
"data": [
{
"date": "2026-12-25",
"name": "Božič",
"isWorkFree": true,
"type": "praznik"
},
{
"date": "2026-12-26",
"name": "Dan samostojnosti in enotnosti",
"isWorkFree": true,
"type": "praznik",
"description": "Razglasitev rezultatov plebiscita o samostojnosti leta 1990"
}
]
}Tipi praznikov
Možne vrednosti polja "type"
praznik
Državni praznik
spominski-dan
Spominski dan
dogodek
Pomemben dogodek
⚡ Brezplačna uporaba
API je brezplačen za uporabo. Prosimo za razumno uporabo - omejitev je 100 zahtev na minuto na IP naslov.