Wie verknüpfe/synchronisiere ich das Semesterprogramm mit unserer Homepage?

Die im System eingegebenen Termine des Semesterprogramms können Sie mittels einer Schnittstelle auf Ihrer Webseite einbinden. Allerdings ist hier ein klein wenig Entwickler-Know-How nötig.

Mit https://<subdomain>.<corpshaus2.de>/api/v1/open_events.json (wobei <subdomain> für ihre Subdomain steht und ersetzt werden müsste, entsprechend müsse auch <corpshaus2.de> durch habemus.app oder gaudeam.de ersetzt werden) erhalten Sie alle Semesterprogramm Termine im JSON-Format. Diese können dann entsprechend eingelesen und dargestellt werden. Noch bieten wir hierfür leider kein komfortables Widget an, aber bis jetzt hatte fast jede Verbindung einen eigenen Mann in den Reihen, der das Semesterprogramm mit dieser Datei auf der eigenen Website einbinden konnte.

Falls Sie den Kalender als iCal-Feed einbinden möchten, können Sie die Dateiendung .ics statt .json verwenden, also: https://<subdomain>.<corpshaus2.de>/api/v1/open_events.ics. Der Feed springt nach dem Ablauf der letzten Veranstaltung des aktuellen Semesters bereits zum Folgesemester, sofern es bereits Veranstaltungen dort im Semesterprogramm gibt. In jedem Fall erfolgt spätestens zu den Stichtagen 01.04. und 30.09. der Wechsel des Semesterprogrammes auf das nun laufende Semester.

Leider sind die Semesterzeiten nicht anpassbar. Als Alternative können zusätzlich noch das Argument limit mit übergeben, um so ab dem gewünschten Semester bis zu 100 Termine zu erhalten, egal in welchem (zukünftigen) Semester: https://<subdomain>.<corpshaus2.de>/api/v1/open_events.ics?year=yyyy&semester=ss&limit=30, wobei “yyyy” für das Jahr (für WS das Jahr angeben, in dem das gewünschte WS startet) und “ss” durch “ws” für das Wintersemester oder “ss” für das Sommersemester ersetzt werden kann. Die Parameter “year” und “semester” müssen immer zusammen angegeben werden, falls sie angegeben werden. Das Argument “limit” kann damit kombiniert werden oder alleine verwendet werden, um sich auf die automatische Semesterlogik zu verlassen, aber Termine über das Semester hinaus zu erhalten.