Webhook

Webhooks sind eine Methode, mit der eine Anwendung automatisch eine Nachricht oder eine Anfrage an eine andere Anwendung sendet, sobald ein bestimmtes Ereignis eintritt. Im Gegensatz zu traditionellen APIs, bei denen eine Anwendung aktiv Anfragen stellen muss, um Informationen abzurufen (Pull-Modell), ermöglicht ein Webhook den sofortigen Push von Daten, sobald diese verfügbar sind.

Webhook können im Falle von LineMetrics verwendet werden, um Sensor Daten an einen definierten Endpunkt zu übertragen.

Integration

Für die Integration über einen Webhook muss nur die jeweilige 'Base URL' für den Aufruf durch den Kunden an LineMetrics übermittelt werden.

Unterstütztes Format

Beispiel

{
  "data": {
    "dataProvider": {
      "devEui": "12345abcdef",
      "lmId": "12345"
    },
    "dataStream": {
      "measurement": "temperature"
    },
    "dataPoint": {
      "timestamp": 1704897825000,
      "value": {
        "value": 123,
        "min": 123,
        "max": 123
      }
    }
  }
}

Schema

data

{ }

dataProvider

{ }

devEui string	Eindeutige, vom Hersteller vergebene ID des Sensors
lmId string	linemetrics ID des Sensors

dataStream

{ }

measurement

string

Type des Sensorwerts (zB temperature)

dataPoint

{ }

timestamp

number

Zeitstempel der Erfassung des Werts (Unix Timestamp in Millisekunden)

value

{ }

value number	Sensorwert
min number	undefined
max number	undefined