NextBreak

Otevřená data

Školní prázdniny pro vývojáře

Všechny školní kalendáře z NextBreak ve formátech JSON, CSV a iCal, zdarma k použití s uvedením zdroje. Vítáme cestovní weby, školní aplikace, chytré domácnosti i výzkumníky.

API pro JSON a CSV

Bez klíče a bez registrace. Odpovědi se ukládají do mezipaměti na několik hodin; dodržujte prosím zhruba dva požadavky 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}'

U každých prázdnin najdete anglický a místní název, druh (autumn, christmas, winter, spring, may, summer, other), první a poslední den (end je null, pokud ho úřad ještě nezveřejnil), školní rok a oficiální zdroj, podle kterého byly ověřeny.

Odběry kalendáře (iCal)

Každý kalendář má odběrovou adresu, která se sama aktualizuje, když úřad změní termín. Najdete ji na stránce každého kalendáře pod volbou „Přidat všechny prázdniny do kalendáře“.

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

Home Assistant

Pomocí odběru kalendáře můžete o prázdninách vypnout budíky na školní dny i plány vytápění.

  1. V Home Assistantu otevřete Nastavení → Zařízení a služby → Přidat integraci → Vzdálený kalendář (Remote calendar).
  2. Vložte iCal adresu svého kalendáře (například výše uvedenou adresu pro Bavorsko) a pojmenujte ho.
  3. Novou entitu kalendáře použijte v automatizacích: během školní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 }

Licence

Data jsou zveřejněna pod licencí CC BY 4.0: můžete je použít v jakémkoli projektu, i komerčním, s uvedením „NextBreak (nextbreak.app)“ a odkazem.

Termíny pocházejí od školských úřadů; školy mohou přidat několik vlastních volných dnů. Než naplánujete něco, co nejde přesunout, ověřte si zdroj.

Zdroje a pokrytí →