NextBreak

Atvērtie dati

Skolēnu brīvdienas izstrādātājiem

Visi NextBreak skolu kalendāri JSON, CSV un iCal formātā, brīvi lietojami ar atsauci uz avotu. Laipni gaidīti ceļojumu vietņu, skolu lietotņu un viedo māju veidotāji, kā arī pētnieki.

JSON un CSV API

Bez atslēgas un bez reģistrācijas. Atbildes tiek kešotas dažas stundas; lūdzu, nesūtiet vairāk par aptuveni diviem pieprasījumiem 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}'

Katram brīvdienu periodam ir angļu un vietējais nosaukums, veids (autumn, christmas, winter, spring, may, summer, other), pirmā un pēdējā diena (end ir null, ja iestāde to vēl nav publicējusi), mācību gads un oficiālais avots, ar kuru tas pārbaudīts.

Kalendāru plūsmas (iCal)

Katram kalendāram ir plūsma, kas atjauninās automātiski, kad iestāde maina datumu. Adrese atrodama katra kalendāra lapā sadaļā „Pievienot kalendāram visas brīvdienas”.

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

Home Assistant

Izmantojiet kalendāra plūsmu, lai brīvdienās izslēgtu mācību dienu modinātājus un apkures grafikus.

  1. Home Assistant atveriet Settings → Devices & services → Add integration → Remote calendar.
  2. Ielīmējiet sava kalendāra iCal adresi (piemēram, iepriekš norādīto Bavārijas kalendāra adresi) un piešķiriet tam nosaukumu.
  3. Izmantojiet jauno kalendāra entītiju automatizācijās: skolēnu brīvdienu laikā tā ir ieslēgta.
# 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 }

Licence

Dati publicēti ar licenci CC BY 4.0: izmantojiet tos jebkurā projektā, arī komerciālā, un norādiet „NextBreak (nextbreak.app)” ar saiti.

Datumus nosaka izglītības iestādes; skolas var pievienot dažas savas brīvdienas. Pirms plānojat kaut ko, ko nevar pārcelt, pārbaudiet avotu.

Avoti un pārklājums →