| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
| development:api:reference [2016/07/19 15:56] – schnello | development:api:reference [2018/04/03 13:53] – Link ins Git korrigiert jau |
|---|
| |[integer]|eine Ganzzahl mit optionalem Vorzeichen|/[+-]?\d+/| | |[integer]|eine Ganzzahl mit optionalem Vorzeichen|/[+-]?\d+/| |
| |[float]|eine Gleitkommazahl;\\ Dezimalpunkt ist "."| | | |[float]|eine Gleitkommazahl;\\ Dezimalpunkt ist "."| | |
| |[timestamp]|hier sind alle Formate gemäß "[[http://de3.php.net/manual/en/datetime.formats.php|PHP Date and Time Formats]]" erlaubt;\\ es können aber auch einfach nur die Anzahl der ms nach 1970 angegeben werden;\\ alle Zeitangaben beziehen sich auf die [[http://de.wikipedia.org/wiki/Koordinierte_Weltzeit|Koordinierte Weltzeit (UTC)]]\\ Der timestamp ist in Millisekunden anzugeben!| | | |[timestamp]|hier sind alle Formate gemäß "[[http://php.net/manual/en/datetime.formats.php|PHP Date and Time Formats]]" erlaubt;\\ es können aber auch einfach nur die Anzahl der ms nach 1970 angegeben werden;\\ alle Zeitangaben beziehen sich auf die [[http://de.wikipedia.org/wiki/Koordinierte_Weltzeit|Koordinierte Weltzeit (UTC)]]\\ Der timestamp ist in Millisekunden anzugeben!| | |
| |[uuid]|jede nach [[http://www.ietf.org/rfc/rfc4122.txt|RFC4122]] valide UUID|/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/| | |[uuid]|jede nach [[http://www.ietf.org/rfc/rfc4122.txt|RFC4122]] valide UUID|/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/| |
| |[numeric]|ist [float] oder [integer]| | | |[numeric]|ist [float] oder [integer]| | |
| |&to=[timestamp]|Endzeitpunkt für die Messwertreihe\\ Wird hier ein [[http://php.net/manual/en/datetime.formats.relative.php|relativer Wert]] angegeben, bezieht sich dieser auf //&from//.\\ Ist //&from// nicht angegeben bezieht er sich auf //jetzt//|//jetzt//|ja| | |&to=[timestamp]|Endzeitpunkt für die Messwertreihe\\ Wird hier ein [[http://php.net/manual/en/datetime.formats.relative.php|relativer Wert]] angegeben, bezieht sich dieser auf //&from//.\\ Ist //&from// nicht angegeben bezieht er sich auf //jetzt//|//jetzt//|ja| |
| |
| * "week" ist derzeit nicht implementiert: https://github.com/volkszaehler/volkszaehler.org/blob/master/lib/Volkszaehler/Util/Aggregation.php#L56 | * "week" ist derzeit nicht implementiert: https://github.com/volkszaehler/volkszaehler.org/blob/master/lib/Util/Aggregation.php#L68 |
| |
| <note>Die Antwort wird in Form eines JSON-Arrays zurück geliefert. z.B.: | <note>Die Antwort wird in Form eines JSON-Arrays zurück geliefert. z.B.: |
| |txt|einfache Textausgabe|ja| | |txt|einfache Textausgabe|ja| |
| |csv|[[http://www.ietf.org/rfc/rfc4180.txt|Komma-separierte Werte]]|ja| | |csv|[[http://www.ietf.org/rfc/rfc4180.txt|Komma-separierte Werte]]|ja| |
| |png|Plotting Ausgabe mit [[http://jpgraph.net|jpGraph]]\\ Die Graphen werden durch die Middleware gerendert\\ und als Rastergrafik ausgegeben|(noch nicht implementiert)| | |png|Plotting Ausgabe mit [[http://jpgraph.net|jpGraph]]\\ Die Graphen werden durch die Middleware gerendert\\ und als Rastergrafik ausgegeben|ja (falls jpGraph installiert)| |
| |gif|:::|:::| | |gif|:::|:::| |
| |jpg|:::|:::| | |jpg|:::|:::| |
| |options|string|Optionen|keine|ja| | |options|string|Optionen|keine|ja| |
| | | |//raw//: Daten ohne Verarbeitung ausgeben (z.B. Zählerstände)| | | | | | |//raw//: Daten ohne Verarbeitung ausgeben (z.B. Zählerstände)| | | |
| ==== JSON ==== | |
| ^Parameter^Beschreibung^ | |
| |&padding=//funcname//|[[http://en.wikipedia.org/wiki/JSON#JSONP|JSON with padding]]| | |
| |
| ==== Plotting ==== | ==== Plotting ==== |
