NextBreak

Otvorené dáta

Školské prázdniny pre vývojárov

Všetky školské kalendáre na NextBreak vo formátoch JSON, CSV a iCal, na voľné použitie s uvedením zdroja. Vítané sú cestovné weby, školské aplikácie, inteligentné domácnosti aj výskumníci.

API pre JSON a CSV

Bez kľúča a bez registrácie. Odpovede sa na niekoľko hodín ukladajú do vyrovnávacej pamäte; dodržiavajte, prosím, približne dve požiadavky za sekundu.

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

Pri každých prázdninách nájdete anglický a miestny názov, druh (autumn, christmas, winter, spring, may, summer, other), prvý a posledný deň (end je null, ak ho orgán ešte nezverejnil), školský rok a oficiálny zdroj, podľa ktorého boli overené.

Kalendárové kanály (iCal)

Každý kalendár má kanál, ktorý sa sám aktualizuje, keď orgán zmení termín. Adresu nájdete na stránke každého kalendára v časti „Pridať všetky prázdniny do kalendára“.

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

Home Assistant

Pomocou kalendárového kanála môžete počas prázdnin vypnúť budíky na školské dni a rozvrhy kúrenia.

  1. V Home Assistant otvorte Nastavenia → Zariadenia a služby → Pridať integráciu → Remote calendar.
  2. Vložte iCal adresu svojho kalendára (napríklad tú pre Bavorsko vyššie) a pomenujte ho.
  3. Novú entitu kalendára použite v automatizáciách: počas školských prázdnin je zapnutá.
# 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 }

Licencia

Údaje sú zverejnené pod licenciou CC BY 4.0: môžete ich použiť v akomkoľvek projekte, aj komerčnom, s uvedením „NextBreak (nextbreak.app)“ a odkazom.

Termíny pochádzajú od školských orgánov; školy si môžu pridať niekoľko vlastných dní. Skôr než naplánujete niečo, čo sa nedá presunúť, overte si zdroj.

Zdroje a pokrytie →