Kalenteri-API

Maksuton, vain luettava JSON-rajapinta nimipäiville, juhlapyhille, liputuspäiville, kuun vaiheelle ja viikkonumeroille. Ei avainta, ei rekisteröitymistä. Rajapinta vastaa sen kalenterin tiedoilla, jonka osoitteesta sitä kutsut.

https://suomalainenkalenteri.app/api/v1

Päätepisteet

GET /api/v1/today
Kaikki tämän päivän tiedot.
GET /api/v1/date/2026-12-06
Tietty päivä muodossa VVVV-KK-PP.
GET /api/v1/name-day/Anna
Milloin nimeä vietetään, tänä ja ensi vuonna.

Vastauksen kentät

date: ISO-päivämäärä, VVVV-KK-PP.
weekday: Viikonpäivän nimi paikallisella kielellä.
weekNumber: ISO 8601 -viikkonumero, 1–53.
nameDay: Sinä päivänä vietettävät nimet.
holidays: Juhlapyhät, kullakin nimi ja tunnus.
flagDays: Viralliset liputuspäivät, kullakin nimi ja tunnus.
moon: Kuun vaihe ja valaistun osan osuus.

Esimerkkivastaus

Live-vastaus tältä kalenterilta tänään:

{
  "locale": "fi",
  "date": "2026-06-03",
  "weekday": "keskiviikko",
  "weekNumber": 23,
  "nameDay": {
    "names": [
      "Orvokki",
      "Viola"
    ]
  },
  "holidays": [],
  "flagDays": [],
  "moon": {
    "phase": "waningGibbous",
    "illumination": 0.938
  }
}

Kutsuraja

Enintään 60 kutsua minuutissa IP-osoitetta kohden. Vastaukset säilyvät välimuistissa tunnin, joten useimmat sovellukset eivät törmää rajaan. Rajan ylitys palauttaa koodin 429 ja Retry-After-otsakkeen.

Käyttöehdot

Käytä vapaasti sovelluksissa, sivustoilla ja harrasteprojekteissa. Linkki takaisin Suomalainen Kalenteri-palveluun on tervetullut mutta ei pakollinen. Tiedot voivat muuttua, joten käsittele jokaista vastausta hetken kuvana.