1.30.2.1. CGI-Webservices¶
| Kontakt: | Alexander Neumann <alneuman@techfak.uni-bielefeld.de> |
|---|---|
| CITK: | |
| Vorbedingung: | Die CGI-Skripte benötigen tools/kogniserver bzw. die unter tools/kogniconfig hinterlegte Konfiguration, damit KogniServer die Skripte korrekt einbindet. |
| Quickstart: | Die Skripte müssen nur an die konfigurierte Stelle kopiert werden. Dies kann durch das vorhandene Makefile geschehen: $ prefix=/vol/kognihome/releases/nightly make install
|
Danach kann unter localhost:8181/cgi/<script_name> (bei Standardeinstellungen für kogniserver)
das entsprechende Skript angesprochen werden.
1.30.2.1.1. Wetterdaten abfragen¶
Wetterdaten werden mit dem Script weather verarbeitet. Der Dienstleister ist OpenWeather.
Folgende Parameter werden benötigt:
- lat – Geografische Breite
- lon – Geografische Länge
- unit (optional, default=’metric’) – Einheit der Temperaturwerte
1.30.2.1.2. ÖPNV-Informationen abfragen¶
VRR-Daten können über das Skript station abgefragt werden. Der Echtzeitdatenmonitor
der VRR beinhaltet under anderem auch Bielefeld (mobiel) und Köln.
Akzeptierte Parameter sind:
- id (integer) – wird eine Stations-ID übergeben, ist die Antwort ein JSON-Dokument mit Abfahrtsinformationen
- station (String) – wird ein Stations-String und keine ID übergeben, beinhaltet die Antwort eine Liste von Stationen mit dem übergebenen Namen und deren IDs.
1.30.2.1.3. Anmerkung zum den Webservices¶
Beide Services arbeiten mit API-Keys, also indivualisierten Schlüssln, welche in den CGI-Scripts hinterlegt sind. Bitte machen Sie diese Skripte NICHT öffentlich zugänglich da ein Missbrauch der Schlüssel zu deren Sperrung führen kann. Außerdem kann es sein, dass die Schlüssel nach einer gewissen Zeit ihre Gültigkeit verlieren und neu beantragt werden müssen. Um diesen Fall zu verifizieren, müssen die REST-APIs einmal händisch mit dem Key angesprochen werden. Aus der Antwort des Dienstes sollte ersichtlich sein, ob der Key noch valide ist oder nicht.