NextBreak

Atvirieji duomenys

Mokinių atostogos programuotojams

Visi NextBreak mokyklų kalendoriai JSON, CSV ir iCal formatais – naudokite nemokamai, nurodę šaltinį. Laukiame kelionių svetainių, mokyklų programėlių, išmaniųjų namų kūrėjų ir tyrėjų.

JSON ir CSV API

Jokio rakto ir registracijos. Atsakymai kelias valandas saugomi podėlyje; prašome siųsti ne daugiau kaip apie dvi užklausas 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}'

Kiekvienos atostogos turi anglišką ir vietinį pavadinimą, rūšį (autumn, christmas, winter, spring, may, summer, other), pirmąją ir paskutinę dieną (end yra null, kai institucija pabaigos dar nepaskelbė), mokslo metus ir oficialų šaltinį, pagal kurį jos patikrintos.

Kalendorių prenumeratos (iCal)

Kiekvienas kalendorius turi prenumeratos adresą, kuris atsinaujina pats, kai institucija pakeičia datą. Adresą rasite kiekvieno kalendoriaus puslapyje, skiltyje „Pridėti visas atostogas į kalendorių“.

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

Home Assistant

Naudokite kalendoriaus prenumeratą, kad per atostogas išjungtumėte mokyklinių dienų žadintuvus ir šildymo grafikus.

  1. Home Assistant atidarykite Settings → Devices & services → Add integration → Remote calendar.
  2. Įklijuokite savo kalendoriaus iCal adresą (pavyzdžiui, aukščiau nurodytą Bavarijos) ir suteikite jam pavadinimą.
  3. Naudokite naują kalendoriaus objektą automatizavimuose: per mokinių atostogas jis būna įjungtas (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 }

Licencija

Duomenys skelbiami pagal CC BY 4.0 licenciją: naudokite juos bet kuriame projekte, taip pat ir komerciniame, nurodę „NextBreak (nextbreak.app)“ su nuoroda.

Datas nustato švietimo institucijos; mokyklos gali pridėti kelias savo laisvas dienas. Prieš planuodami tai, ko negalėsite perkelti, pasitikrinkite šaltinį.

Šaltiniai ir aprėptis →