Push-API
Die Push-API leitet jedes Gerätedatenpaket an einen HTTP-Endpunkt Ihrer Wahl weiter, sobald es in der Sensorbee Cloud eingeht. Sie müssen nichts abfragen – Sensorbee sendet die Daten per POST in dem Moment, in dem sie empfangen werden. Das ist die richtige Integration, wenn Sie Echtzeitdaten brauchen: Live-Dashboards, Alarme, Stream-Verarbeitung.
Für Abfragen bei Bedarf (historische Auswertungen, Berichte) verwenden Sie stattdessen die REST-API.
Push-API konfigurieren
| Parameter | Pflicht | Beschreibung |
|---|---|---|
| Push API Name | Ja | Ein Name zur Kennzeichnung der Integration (z. B. Station 1 Push API). |
| Endpoint URL | Ja | Ein HTTP-POST-Endpunkt, der die Datenpakete empfängt. |
| Description | Nein | Freitextbeschreibung. |
| Header Params | Nein | Schlüssel-Wert-Header, die jedem POST hinzugefügt werden – nützlich für apiKey, Bearer-Token usw. |
Einem Gerät zuweisen
Nach dem Anlegen der Push-API weisen Sie sie einem Gerät in dessen Registerkarte Info zu. Danach wird das Datenpaket des Geräts in jedem Abfrageintervall an Ihren Endpunkt weitergeleitet.
Format der Datenpakete
Die Datenpakete folgen der Smart-City-Vorlage – einem festen JSON-Schema, das Installationsmetadaten, GPS, alle Partikel und Gase, Wetter, Gerätezustand und Erschütterung abdeckt. Nur die Felder der am Gerät verbauten Sensoren sind gefüllt; die übrigen bleiben leer.