NextBreak

Odprti podatki

Šolske počitnice za razvijalce

Vsi šolski koledarji na NextBreak v formatih JSON, CSV in iCal, prosto za uporabo z navedbo vira. Dobrodošli so turistične strani, šolske aplikacije, pametni domovi in raziskovalci.

API za JSON in CSV

Brez ključa in brez registracije. Odgovori so predpomnjeni nekaj ur; prosimo, ne pošiljajte več kot približno dveh zahtev na sekundo.

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}'

Vsake počitnice imajo angleško in lokalno ime, vrsto (autumn, christmas, winter, spring, may, summer, other), prvi in zadnji dan (end je null, če ga pristojni organ še ni objavil), šolsko leto in uradni vir, s katerim so bile preverjene.

Koledarski viri (iCal)

Vsak koledar ima vir, ki se sam posodobi, ko pristojni organ spremeni datum. Naslov najdete na strani vsakega koledarja pod »Dodajte vse počitnice v koledar«.

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

Home Assistant

S koledarskim virom med počitnicami izklopite budilke za šolske dni in urnike ogrevanja.

  1. V Home Assistant odprite Nastavitve (Settings) → Naprave in storitve (Devices & services) → Dodaj integracijo (Add integration) → Remote calendar.
  2. Prilepite naslov iCal svojega koledarja (na primer zgornjega za Bavarsko) in mu dajte ime.
  3. Novo koledarsko entiteto uporabite v avtomatizacijah: med šolskimi počitnicami ima stanje »on«.
# 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 }

Licenca

Podatki so objavljeni pod licenco CC BY 4.0: uporabite jih lahko v katerem koli projektu, tudi komercialnem, z navedbo »NextBreak (nextbreak.app)« in povezavo.

Termine določajo organi za izobraževanje; šole lahko dodajo nekaj lastnih prostih dni. Preden načrtujete kaj, česar ni mogoče prestaviti, preverite vir.

Viri in pokritost →