292
Bearbeitungen
Projekt:Schaffenbot: Unterschied zwischen den Versionen
keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 124: | Zeile 124: | ||
crontab -e | crontab -e | ||
* * * * * php /var/www/telegrambot-webroot/cron.php | * * * * * php /var/www/telegrambot-webroot/cron.php | ||
=Schaffenburg Data Tracking= | |||
Es gibt eine Möglichkeit Daten aller Art zu loggen.<br /> | |||
Der Schaffenburg-Telegram-Bot kann auf diese Daten zugreifen und sie der Allgemeinheit zur Verfügung stellen.<br /> | |||
Aktuell sind folgende Daten in das Data-Tracking eingebunden:<br /> | |||
* Status der Räumlichkeiten von Schaffenburg e.V. (Offen, Geschlossen) | |||
* Temperatur in den Räumlichkeiten von Schaffenburg e.V. | |||
* Mülleimerstatus (Regelmäßiges leeren der Mülleimer) | |||
* Anwesenheits-Summary (Personen können freiwillig angeben, ob sie in den Räumlichkeiten sind/sein werden) | |||
==Daten loggen== | |||
Über die folgende URL können Daten ins Logging aufgenommen werden:<br /> | |||
http://codeblatz.ddns.net/soap.php?token=<secret token>&tag=<string>&value=<string> <br /> | |||
Erklärung:<br /> | |||
* token: Damit nicht jeder einfach Daten loggen kann, muss ein valider Token in der URL mitgegeben werden.<br />Ein neuer Token kein beim Benutzer [[Benutzer:VinRisen360|Paul Freudenberger]] angefordert werden. | |||
* tag: Ein Search-Tag, der mit den Infos hinterlegt wird.<br />Es sollte ein einzelnes Wort sein, dass beschreibend für den Wert ist. (Beispiel: temperature) | |||
* value: Der eigentliche Wert, den man loggen möchte.<br />Hier kann eigentlich alles mitgegeben werden. | |||
==Daten auslesen== | |||
Über die folgende URL können die Daten wieder ausgelesen werden:<br /> | |||
http://codeblatz.ddns.net/soap.php?token=<secret token>[&tag=<string>][&limit=100] <br /> | |||
Erklärung:<br /> | |||
* token: Damit nicht jeder einfach Daten auslesen kann, muss ein valider Token in der URL mitgegeben werden.<br />Ein neuer Token kein beim Benutzer [[Benutzer:VinRisen360|Paul Freudenberger]] angefordert werden. | |||
* tag: OPTIONAL: Filtert die LOG-Ausgabe auf Werte mit dem angegebenen Search-Tag.<br />Wenn kein tag angegeben wird, werden alle Datensätze aus dem Log ausgegeben. | |||
* limit: OPTIONAL: Die Anzahl der Datensätze bei der Ausgabe festlegen.<br />Wenn kein limit angegeben wird, wird nur der neuste Datensatz ausgegeben | |||
AUSGABEFORMAT:<br /> | |||
Die Daten werden in Form eines JSON-Files ausgegeben.<br /> | |||
Beispiel:<br /> | |||
{"time":"22.10.2017 00:00:01","spacetemperature":20.5,"metric":"C (degree Celsius)"}<br /> | |||
=Nett-to-know= | =Nett-to-know= | ||
| Zeile 145: | Zeile 175: | ||
http://api.openweathermap.org/data/2.5/weather?q=Berlin&units=metric&APPID=z825bl24x5xx1p44w9i6c3g1g22ve299 | http://api.openweathermap.org/data/2.5/weather?q=Berlin&units=metric&APPID=z825bl24x5xx1p44w9i6c3g1g22ve299 | ||
* Die meisten Commands haben in ihren Klassen "extends UserCommand" stehen. Dies bedeutet jeder Nutzer kann diesen Command triggern | * Die meisten Commands haben in ihren Klassen "extends UserCommand" stehen. Dies bedeutet jeder Nutzer kann diesen Command triggern | ||
* Manche Commands haben in ihren Klassen "extends AdminCommand" stehen. Dies bedeutet, nur Nutzer deren ID unter /[webroot]/hook.php im Array $admin_users = []; gelistet sind können diesen Command triggern <br /> | * Manche Commands haben in ihren Klassen "extends AdminCommand" stehen.Dies bedeutet, nur Nutzer deren ID unter /[webroot]/hook.php im Array $admin_users = []; gelistet sind können diesen Command triggern <br /> | ||
* Manche Commands haben in ihren Klassen "extends SystemCommand" stehen. Dies bedeutet der Command wird nicht unter /help aufgelistet, es gibt ihn aber <br /> | * Manche Commands haben in ihren Klassen "extends SystemCommand" stehen. Dies bedeutet der Command wird nicht unter /help aufgelistet, es gibt ihn aber <br /> | ||