NextBreak

Data miftuħa

Btajjel tal-iskola għall-iżviluppaturi

Kull kalendarju skolastiku fuq NextBreak bħala JSON, CSV u iCal, b'xejn bl-attribuzzjoni. Siti tal-ivvjaġġar, apps tal-iskejjel, djar intelliġenti u riċerkaturi huma lkoll milqugħa.

API JSON u CSV

Bla ċavetta u bla reġistrazzjoni. It-tweġibiet jinżammu fil-cache għal ftit sigħat; jekk jogħġbok żomm madwar żewġ talbiet kull sekonda.

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

Kull btala għandha isimha bl-Ingliż u bil-lingwa lokali, it-tip tagħha (autumn, christmas, winter, spring, may, summer, other), l-ewwel u l-aħħar jum (end huwa null meta l-awtorità għadha ma ppubblikathiex), is-sena skolastika, u s-sors uffiċjali li miegħu ġiet ivverifikata.

Feeds tal-kalendarju (iCal)

Kull kalendarju għandu feed li jaġġorna waħdu meta awtorità tibdel data. L-indirizz jinsab fil-paġna ta' kull kalendarju, taħt "Żid il-btajjel kollha mal-kalendarju tiegħek".

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

Home Assistant

Uża feed tal-kalendarju biex titfi l-allarmi tal-jiem tal-iskola u l-iskedi tat-tisħin matul il-btajjel.

  1. F'Home Assistant, iftaħ Settings → Devices & services → Add integration → Remote calendar.
  2. Waħħal l-indirizz iCal tal-kalendarju tiegħek (pereżempju dak tal-Bavarja hawn fuq) u agħtih isem.
  3. Uża l-entità l-ġdida tal-kalendarju fl-awtomazzjonijiet: tkun attiva (on) matul btala tal-iskola.
# 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 }

Liċenza

Id-data hija ppubblikata taħt CC BY 4.0: użaha fi kwalunkwe proġett, anki kummerċjali, u semmi "NextBreak (nextbreak.app)" b'link.

Id-dati ġejjin mill-awtoritajiet edukattivi; l-iskejjel jistgħu jżidu ftit jiem tagħhom. Iċċekkja s-sors qabel ma tippjana xi ħaġa li ma tistax tiċċaqlaq.

Sorsi u kopertura →