NextBreak

Dati aperti

Vacanze scolastiche per sviluppatori

Tutti i calendari scolastici di NextBreak in JSON, CSV e iCal, liberi da usare citando la fonte. Siti di viaggi, app per la scuola, domotica e ricercatori sono i benvenuti.

API JSON e CSV

Nessuna chiave e nessuna registrazione. Le risposte restano in cache per qualche ora; ti chiediamo di non superare circa due richieste al secondo.

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

Ogni periodo di vacanza ha il nome inglese e quello locale, il tipo (autumn, christmas, winter, spring, may, summer, other), il primo e l'ultimo giorno (end è null quando l'autorità non l'ha ancora pubblicato), l'anno scolastico e la fonte ufficiale su cui è stato verificato.

Calendari in abbonamento (iCal)

Ogni calendario ha un feed che si aggiorna da solo quando un'autorità cambia una data. L'indirizzo si trova in ogni pagina di calendario, sotto “Aggiungi tutte le vacanze al tuo calendario”.

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

Home Assistant

Usa un calendario in abbonamento per disattivare le sveglie dei giorni di scuola e i programmi del riscaldamento durante le vacanze.

  1. In Home Assistant apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Remote calendar.
  2. Incolla l'indirizzo iCal del tuo calendario (per esempio quello della Baviera qui sopra) e dagli un nome.
  3. Usa la nuova entità calendario nelle automazioni: è attiva durante le vacanze scolastiche.
# 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 }

Licenza

I dati sono pubblicati con licenza CC BY 4.0: usali in qualsiasi progetto, anche commerciale, citando “NextBreak (nextbreak.app)” con un link.

Le date provengono dalle autorità scolastiche; le scuole possono aggiungere qualche giorno di chiusura. Controlla la fonte prima di pianificare qualcosa che non si può spostare.

Fonti e copertura →