Dies ist ein einfacher Node.js-Server, der einen Stundenplan von WebUntis abruft und in verschiedenen Formaten zurückgibt. Der Server wurde entwickelt, um auf Anfragen zu reagieren und Stundenplandaten über HTTP bereitzustellen.
Bevor Sie den Server ausführen können, müssen Sie sicherstellen, dass Node.js auf Ihrem System installiert ist. Außerdem benötigen Sie die folgenden Node.js-Pakete, die in der package.json-Datei aufgeführt sind:
http: Das integrierte HTTP-Modul von Node.js.webuntis: Eine Bibliothek zur Interaktion mit dem WebUntis-System.date-fns: Eine Bibliothek zur Verarbeitung von Datum und Uhrzeit.date-fns/locale/de: Ein Datei zur Unterstützung der deutschen Sprache.
- Klonen Sie dieses Repository auf Ihren Computer.
- Navigieren Sie in das Verzeichnis des Projekts und führen Sie
npm installaus, um die erforderlichen Abhängigkeiten zu installieren.
-
Starten Sie den Server mit dem Befehl
npm start. -
Der Server läuft standardmäßig auf Port 3000. Sie können die Portnummer in der
server.js-Datei anpassen. -
Sie können den Stundenplan abrufen, indem Sie Anfragen an die folgenden Endpunkte senden:
GET /stundenplan/weekly/YYYY-MM-dd: Abrufen des Wochenstundenplans für das angegebene Datum (ersetzen Sie YYYY-MM-dd durch das gewünschte Datum).GET /stundenplan/raw/YYYY-MM-dd: Abrufen des Rohstundenplans für das angegebene Datum.
-
Sie müssen die folgenden Header-Informationen in Ihren Anfragen bereitstellen:
school: Ihre Schuleusername: Ihr Benutzernamepassword: Ihr Passworthost: WebUntis Hostname
Beispiel für eine Anfrage mit cURL:
curl -X GET "http://localhost:3000/stundenplan/weekly/2023-09-18" -H "school: Ihre_Schule" -H "username: Ihr_Benutzername" -H "password: Ihr_Passwort" -H "host: WebUntis_Hostname"