API v1 · stabiilne · CC-BY-4.0

Soome riigipühade API

Hangi Soome riigipühade kuupäevad ja puhkusesildade võimalused JSONina. Vali marsruut, et näha URL-i mustrit, näidet ja vastuse välju.

Proovi

Üks curl-käsk, üks JSON-fail. Võtmeid ega registreerumist pole vaja.

terminalNäidisseanss · vastus lühendatud

$ curl https://vapaapaivat.com/api/v1/fi/holidays/2026.json
# 200 OK · application/json

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "timezone": "Europe/Helsinki",
  "holidays": [
    {
      "id": "newyear",
      "date": "2026-01-01",
      "name": {
        "fi": "Uudenvuodenpäivä",
        "en": "New Year's Day",
        "sv": "Nyårsdagen",
        "et": "uusaasta",
        "ru": "Новый год",
        "uk": "Новий рік",
        "ar": "رأس السنة الميلادية"
      },
      "official": true,
      "weekend": false,
      "businessDay": false
    }
  ]
}

Marsruudid

Kaks marsruuti tagastavad ühe JSON-faili aasta kohta. Vali marsruut, et näha selle struktuuri.

GETRiigipühad /api/v1/fi/holidays/{year}.json GETPikad nädalavahetused /api/v1/fi/long-weekends/{year}.json

Endpoint: GET /api/v1/fi/holidays/{year}.json

Näide: https://vapaapaivat.com/api/v1/fi/holidays/2026.json

Kuupäevad, nimed ja teave selle kohta, kas päev on ametlik püha, nädalavahetus või tööpäev. Kasuta aastat vahemikus 2000-2099. Aadressi /fi/ segment tähistab Soomet.

Tipptaseme vastus

Väli	Tüüp	Kirjeldus
`apiVersion`	string	API versioon
`jurisdiction`	string	Riik, FI
`year`	number	Kalendriaasta
`timezone`	string	Ajavöönd Europe/Helsinki
`holidays`	array	Riigipüha väljad

Riigipüha väljad

Väli	Tüüp	Kirjeldus
`id`	string	Püsiv püha tunnus
`date`	string	ISO-kuupäev, YYYY-MM-DD
`name`	object	Nimed keeltes fi, sv, en, ar, ru, uk ja et
`official`	boolean	Ametlik riigipüha
`weekend`	boolean	Langeb laupäevale või pühapäevale
`businessDay`	boolean	Soome tööpäev

Endpoint: GET /api/v1/fi/long-weekends/{year}.json

Näide: https://vapaapaivat.com/api/v1/fi/long-weekends/2026.json

Puhkusepäevad, millega saab riigipühad ja nädalavahetused pikemateks vabaperioodideks ühendada. Kasuta aastat vahemikus 2000-2099. Aadressi /fi/ segment tähistab Soomet.

Tipptaseme vastus

Väli	Tüüp	Kirjeldus
`apiVersion`	string	API versioon
`jurisdiction`	string	Riik, FI
`year`	number	Kalendriaasta
`timezone`	string	Ajavöönd Europe/Helsinki
`longWeekends`	array	Pika nädalavahetuse väljad

Pika nädalavahetuse väljad

Väli	Tüüp	Kirjeldus
`startDate`	string	Vaba perioodi algus, YYYY-MM-DD
`endDate`	string	Vaba perioodi lõpp, YYYY-MM-DD
`vacationDays`	string[]	Kasutatavad puhkusepäevad
`vacationDayCount`	number	Puhkusepäevade arv
`totalDaysOff`	number	Järjestikuste vabade päevade arv
`efficiency`	number	Vabu päevi ühe puhkusepäeva kohta
`season`	string	winter või summer

jsonVastus · lühendatud

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "longWeekends": [
    {
      "startDate": "2026-04-03",
      "endDate": "2026-04-06",
      "vacationDays": [],
      "vacationDayCount": 0,
      "totalDaysOff": 4,
      "efficiency": null,
      "season": "spring"
    }
  ]
}

Stabiilsus

v1 on stabiilne. Uued aastad avaldatakse igal novembril. Tagasiühilduvad täiendused jäävad v1-sse; murdvad muudatused avaldatakse teel /api/v2/.

Kas märkasid valet kuupäeva või puuduvat keelt? Teata sellest. Otsid omavalitsuste koolivaheaja andmeid? Vaata datasets. openapi.json