Smart-City-Vorlage

Die Smart-City-Vorlage ist das feste JSON-Schema, das jede Sensorbee-Integration verwendet:

• ·Die Push-API sendet in jedem Abfrageintervall Datenpakete in diesem Format.
• ·Der Endpunkt /report der REST-API liefert Daten in diesem Format.
• ·Der CSV-Export der Seite Bericht verwendet dieselbe Spaltenreihenfolge.

Nur die Felder der tatsächlich am Gerät verbauten Sensoren sind gefüllt. Die übrigen sind leer oder null.

Schema

Die vollständige Parameterreferenz – Installationsmetadaten, GPS, Feinstaub (Masse und Anzahl), Umgebung, Gase, Wetter, externe Sensoren, Stromversorgung und Erschütterung – steht auf der Seite Bericht. Hier gibt es bewusst keine zweite Kopie, damit beide nicht auseinanderlaufen.

Stabilitätsgarantien

• ·Die Reihenfolge bestehender Felder ändert sich nicht.
• ·Neue Felder werden ausschließlich rechts angehängt (bzw. am Ende des JSON-Objekts).
• ·Ein umbenannter Sensor oder eine umbenannte Einheit gilt als neues Feld, nicht als Änderung an Ort und Stelle.

Dadurch brechen Verarbeiter – Ihre Dashboards, ETL-Pipelines, nachgelagerten Datenbanken – nicht, wenn Sensorbee neue Sensoren unterstützt.