Historie und Website-API

Menü → Historie speichert die in der lokalen VyraVolt UI ausgewählten Mess- und Statuswerte in der Premium-History-Infrastruktur. Premium-History wird standardmäßig bis zu 365 Tage aufbewahrt. Die kontobezogene beziehungsweise Backend-Konfiguration kann davon abweichen; die Plattform zeigt die wirksame Aufbewahrung für das gewählte Konto und Gerät.

Abgeschlossene Energie-Tageswerte, Netzbezug, Einspeisung, IR-Zählerstände und Energie-CSV werden unter Energie beschrieben.

Auswahl und Datenübernahme

Wähle oben Gerät und Zeitraum. Für Sample-Zeitreihen stehen 24 Stunden, 7 Tage, 30 Tage und 90 Tage zur Verfügung. Aktualisieren lädt Latest-Werte, Samples und Feature-Status neu.

Die Kennzahlen zeigen letzten Datenpunkt, aktive beziehungsweise gespeicherte Werte, Upload-Intervall und Aufbewahrung. Die zu speichernden Datenpunkte werden in der lokalen VyraVolt UI ausgewählt; die Cloud-Seite dient der Auswertung und Veröffentlichung.

Aktuelle Werte und Zeitreihen

Jede Karte enthält Bezeichnung, Item-ID, Quellgerät, Wert, Einheit, Zeitstempel und Aktualitätsstatus. Die Plattform zeigt echte History-API-Daten und keine Mockdaten.

Nur numerische Samples werden als Linienchart dargestellt. Je nach Datenlage erscheinen letzter Wert, Minimum, Maximum, Sample-Anzahl, Trend und Trendfenster. Boolean-, Text- und Statuswerte werden nicht künstlich als Linie dargestellt. Bei sehr vielen Samples wird die Visualisierung reduziert; die API-Abfrage ist je Zeitraum begrenzt.

Löschen

Löschen entfernt den gewählten Latest-Datenpunkt mit Zeitstempel. Verlauf löschen entfernt nach zweistufiger Bestätigung alle Samples und den Latest-Wert dieser Item-ID aus der AWS-History-Datenbank.

Gelöschte History-Daten können nicht über die Plattform wiederhergestellt werden. Das Löschen eines allgemeinen History-Verlaufs löscht nicht automatisch separate Energie-Tagesabschlüsse.

Fehlerbilder

• Noch keine History-Werte aktiv: Werte in der lokalen VyraVolt UI auswählen.
• Noch keine Daten: erster Upload steht aus.
• Veraltet: letzter Zeitstempel liegt außerhalb des Frischefensters.
• Charts nicht freigeschaltet: die API meldet die Chartfunktion als nicht aktiv.
• Keine Chart-Daten: keine numerischen Samples im Zeitraum.
• Premium unterschiedlich erkannt: Premium-Status neu prüfen, Synchronisierung abwarten und erneut laden.

Website-API

Im Tab Website-API lassen sich ausgewählte History- und freigegebene Energie-Latest-Werte über einen schreibgeschützten JSON-Link veröffentlichen.

1. Linknamen vergeben und nur öffentlich geeignete Werte auswählen.
2. API-Link erstellen und URL kopieren.
3. JSON-Vorschau und Entwicklerbeispiel prüfen.
4. Link bei Bedarf deaktivieren.
5. Token nach unbeabsichtigter Weitergabe rotieren und die URL überall ersetzen.
6. Nicht mehr benötigten Link löschen.

Die Plattform zeigt die geltenden Standard-/Kontolimits. Die aktuelle Standardkonfiguration umfasst einen Link, bis zu 20 Werte je Link, ein Mindestintervall von 15 Minuten, fünf Minuten JSON-Cache und ein Fair-Use-Limit von 10.000 Abrufen pro Tag. Diese Werte sind konfigurierbar; maßgeblich ist die aktuelle Kontoanzeige.

Nach Deaktivierung, Rotation oder Löschen kann die alte Datei bis zum Cacheablauf kurz erreichbar sein. Die Ausgabe erfolgt über CloudFront/S3. Jeder mit dem vollständigen Link kann die ausgewählten Werte lesen; Schreib- und Gerätesteuerung sind ausgeschlossen. Hardware-ID, lokale IP, Konfiguration und nicht ausgewählte Daten werden nicht veröffentlicht. Siehe Öffentliche API.