NextBreak

Nyílt adatok

Iskolai szünetek fejlesztőknek

A NextBreak összes iskolai naptára JSON, CSV és iCal formátumban, a forrás megjelölésével szabadon felhasználható. Utazási oldalakat, iskolai alkalmazásokat, okosotthonokat és kutatókat is szívesen látunk.

JSON és CSV API

Nincs kulcs, nincs regisztráció. A válaszokat néhány óráig gyorsítótárazzuk; kérjük, másodpercenként legfeljebb körülbelül két kérést küldj.

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

Minden szünetnél szerepel az angol és a helyi elnevezés, a fajta (autumn, christmas, winter, spring, may, summer, other), az első és az utolsó nap (az end értéke null, ha a hatóság még nem tette közzé), a tanév és az a hivatalos forrás, amellyel ellenőriztük.

Naptárcsatornák (iCal)

Minden naptárnak van egy csatornája, amely magától frissül, ha egy hatóság módosít egy időpontot. A címet minden naptároldalon megtalálod „Az összes szünet hozzáadása a naptárhoz” alatt.

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

Home Assistant

Egy naptárcsatornával a szünetek idejére kikapcsolhatod a tanítási napokra beállított ébresztőket és fűtési programokat.

  1. A Home Assistantban nyisd meg: Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása → Remote calendar.
  2. Illeszd be a naptárad iCal-címét (például a fenti bajorországit), és adj neki nevet.
  3. Használd az új naptárentitást az automatizálásokban: iskolai szünet idején bekapcsolt (on) állapotban van.
# 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 }

Licenc

Az adatokat CC BY 4.0 licenc alatt tesszük közzé: bármilyen projektben felhasználhatod, akár kereskedelmi célra is, ha linkkel feltünteted a forrást: „NextBreak (nextbreak.app)”.

Az időpontok az oktatási hatóságoktól származnak; az iskolák néhány saját szünnapot is beiktathatnak. Mielőtt bármit véglegesen lefoglalnál, ellenőrizd a forrást.

Források és lefedettség →