NextBreak

Öppna data

Skollov för utvecklare

Alla skolkalendrar på NextBreak som JSON, CSV och iCal, fria att använda med källhänvisning. Resesajter, skolappar, smarta hem och forskare är välkomna.

JSON- och CSV-API

Ingen nyckel och ingen registrering. Svaren cachas i några timmar; håll dig till ungefär två anrop per sekund.

GET https://nextbreak.app/api/v1/calendars              # every calendar (?format=csv)
GET https://nextbreak.app/api/v1/calendars/DE-BY        # one calendar (?year=2026/27, ?format=csv)
GET https://nextbreak.app/api/v1/off?date=2027-02-15    # every calendar off on a date
curl -s https://nextbreak.app/api/v1/calendars/FR-ZC | jq '.breaks[] | {name, start, end}'

Varje lov har sitt engelska och lokala namn, sin typ (autumn, christmas, winter, spring, may, summer, other), första och sista dag (end är null när myndigheten inte har publicerat den ännu), läsår och den officiella källa som det har kontrollerats mot.

Kalenderflöden (iCal)

Varje kalender har ett flöde som uppdateras automatiskt när en myndighet ändrar ett datum. Adressen finns på varje kalendersida under ”Lägg till alla lov i din kalender”.

https://nextbreak.app/ical/germany-bavaria.ics
https://nextbreak.app/ical/latvia.ics

Home Assistant

Använd ett kalenderflöde för att stänga av väckarklockor och värmescheman för skoldagar under loven.

  1. Öppna Inställningar → Enheter och tjänster → Lägg till integration → Remote calendar i Home Assistant.
  2. Klistra in kalenderns iCal-adress (till exempel den för Bayern ovan) och ge den ett namn.
  3. Använd den nya kalenderentiteten i automationer: den är på (on) under ett skollov.
# automations.yaml: no school run on school holidays
- alias: "School morning alarm"
  trigger: { platform: time, at: "06:45:00" }
  condition:
    - condition: state
      entity_id: calendar.school_holidays_bavaria
      state: "off"
  action: { service: script.school_morning }

Licens

Uppgifterna publiceras under CC BY 4.0: använd dem i vilket projekt som helst, även kommersiella, och ange ”NextBreak (nextbreak.app)” med en länk.

Datumen kommer från skolmyndigheterna; skolor kan lägga till några egna lediga dagar. Kontrollera källan innan du planerar något som inte går att flytta.

Källor och täckning →