NextBreak

Données ouvertes

Les vacances scolaires pour les développeurs

Tous les calendriers scolaires de NextBreak en JSON, CSV et iCal, en libre utilisation avec mention de la source. Sites de voyage, applications scolaires, maisons connectées et chercheurs sont les bienvenus.

API JSON et CSV

Sans clé ni inscription. Les réponses sont mises en cache quelques heures ; merci de vous limiter à environ deux requêtes par seconde.

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

Chaque période de vacances comporte son nom anglais et son nom local, son type (autumn, christmas, winter, spring, may, summer, other), son premier et son dernier jour (end vaut null tant que l'autorité ne l'a pas publié), l'année scolaire et la source officielle utilisée pour la vérification.

Flux de calendrier (iCal)

Chaque calendrier dispose d'un flux qui se met à jour automatiquement lorsqu'une autorité modifie une date. L'adresse figure sur chaque page de calendrier, sous « Ajouter toutes les vacances à votre calendrier ».

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

Home Assistant

Utilisez un flux de calendrier pour couper les réveils des jours d'école et adapter les programmes de chauffage pendant les vacances.

  1. Dans Home Assistant, ouvrez Paramètres → Appareils et services → Ajouter une intégration → Remote Calendar (calendrier distant).
  2. Collez l'adresse iCal de votre calendrier (par exemple celle de la Bavière ci-dessus) et donnez-lui un nom.
  3. Utilisez la nouvelle entité de calendrier dans vos automatisations : elle est active pendant les vacances scolaires.
# 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

Les données sont publiées sous licence CC BY 4.0 : utilisez-les dans n'importe quel projet, y compris commercial, en citant « NextBreak (nextbreak.app) » avec un lien.

Les dates proviennent des autorités éducatives ; les écoles peuvent ajouter quelques jours de congé. Vérifiez la source avant de planifier quoi que ce soit qui ne peut pas être déplacé.

Sources et couverture →