NextBreak

Avaandmed

Koolivaheajad arendajatele

Kõik NextBreaki koolikalendrid JSON-, CSV- ja iCal-vormingus, allikale viitamisel tasuta kasutamiseks. Ootame reisisaite, kooliäppe, nutikodusid ja teadlasi.

JSON- ja CSV-API

Võtit ega registreerumist pole vaja. Vastused puhverdatakse mõneks tunniks; palun piirdu umbes kahe päringuga sekundis.

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

Igal vaheajal on ingliskeelne ja kohalik nimetus, liik (autumn, christmas, winter, spring, may, summer, other), esimene ja viimane päev (end on null, kui asutus pole seda veel avaldanud), õppeaasta ja ametlik allikas, mille järgi seda kontrolliti.

Kalendrivood (iCal)

Igal kalendril on voog, mis uueneb ise, kui asutus kuupäeva muudab. Aadress on iga kalendri lehel jaotises „Lisa kõik vaheajad oma kalendrisse“.

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

Home Assistant

Kasuta kalendrivoogu, et koolivaheaegadel koolipäevade äratused ja küttegraafikud välja lülitada.

  1. Ava Home Assistantis Seaded → Seadmed ja teenused → Lisa sidumine → Remote calendar.
  2. Kleebi oma kalendri iCal-aadress (näiteks ülaltoodud Baieri oma) ja anna sellele nimi.
  3. Kasuta uut kalendriolemit automatiseeringutes: koolivaheaja ajal on selle olek sees (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 }

Litsents

Andmed on avaldatud litsentsiga CC BY 4.0: kasuta neid mis tahes projektis, ka ärilises, ja viita allikale „NextBreak (nextbreak.app)“ koos lingiga.

Kuupäevad pärinevad haridusasutustelt; koolid võivad lisada mõne oma vaba päeva. Kontrolli allikat, enne kui plaanid midagi, mida ei saa muuta.

Allikad ja ulatus →