Data Webhook Information

Overview

A Data Push sends data to your end point when data is received at the server. You can configure the destination and query parameters used to route the request. Data is compiled as a JSON body and sent via HTTP POST. Four (4) endpoints available now. Webhook, Watson, Amazon AWS, and Azure IoT Hub. Only one (1) data push allowed per account. To switch data push types, first stop your existing data push, only then will the Create button appear.

Attempts & Retries

Each individual message is attempted up to 4 times unless the total consecutive failure count for all attempts hits 20. After 20 consecutive failures each message is only attempted 1 time up to 100 total consecutive failures. After 100 consecutive failures the webhook is suspended until it is manualy reset. First attempt queued immediately (typically delivered within a few seconds) Second attempt queued after 2 minutes Third attempt queued after 15 minutes Fourth attempt queued after 60 minutes Subsequent attempts only sent after manually being manually re-queued. There is a second limit of 10 total attempts that can be sent. After 10 failed attempts of a particular message (4 auto attempts + 6 manual resend commands) you will need to contact support to release that message.

General Output Format

                        {Gateway Message},
                        SensorMessages:[{Sensor 1 Message}{Sensor 2 Message}{Sensor n Message}],
                        LocationMessages:[{Location 1 Message}{Location 2 Message}{Location n Message}]

Gateway Contents

gatewayID
A unique numeric identifier for the gatewa
gatewayName
User designated gateway identifier.
networkID
A unique numeric identifier for the network.
messageType
Numerical value assigned to message.
power
A numeric value indicating type of power.
batteryLevel
A numeric value indicating battery power level.
date
Time stamp of data message.
count
The number of sensors
signalStrength
Strength of radio signal (0-100).
pendingChange
Has pending configuration transaction to take place.

Sensor Contents

sensorID
A unique numeric identifier for the sensor
sensorName
User designated sensor identifier.
applicationID
Coded Sensor type (2= Temperature, 4= Water, etc.).
networkID
A unique numeric identifier for the network.
dataMessageGUID
A unique identifier for the message.
state
Encoded state data (in general 0= Normal, 2= Aware State)
messageDate
Date message was delivered.
rawData
Raw sensor data.
dataType
Data discription (TemperatureData).
dataValue
Parsed sensor data.
plotValues
Parsed sensor data plot values
plotLabe
Sensor data plot label. (Fahrenheit,Celsius etc.)
batteryLevel
Approximate percentage remaining on battery
signalStrength
Strength of radio signal (0-100).
pendingChange
Has pending configuration transaction to take place.
voltage
A numeric value indicating voltage level

Location Contents

deviceID
A unique numeric identifier for the device.
locationMessageGUI
A unique identifier for the location message.
locationDate
Date location was recorded
state
Encoded state data.
latitude
Latitude at time of recording.
longitude
|Longitude at time of recording.
altitude
Altitude at time of recording.
speed
Speed m/s traveling at time of recording.
course
Compass course traveling at time of recording
fixTime
Number of seconds to aquire coordinates
sateliteCount
Number of satelites used to generate reading.
uncertainty
Expected error in Meters.

Data Example JSON

    {
           "gatewayMessage":{
           "gatewayID":"10000" ,
           "gatewayName":"ExampleGateway" ,
           "accountID":"xxxx" ,
           "networkID":"xxxx" ,
           "messageType":"0" ,
           "power":"0",
           "batteryLevel": "101" ,
           "date": 2022-4-28 21:47:01",
           "count":"3",
           "signalStrength": "29",
           "pendingChange": "False" 
       },
       "sensorMessages":[
          {
              "sensorID":"10001" ,
              "sensorName":"Temp1" ,
              "applicationID":"2" ,
              "networkID":"xxxx" ,
              "dataMessageGUID":"78642056-CBD8-43B0-9A4B-247E58D3B6CB",
              "state": "0" ,
              "messageDate": 2022-4-28 21:48:01",
              "rawData":"23.7",
              "dataType": "TemperatureData",
              "dataValue": "23.7",
              "plotValues": "74.66",
              "plotLabels": "Fahrenheit",                           
              "batteryLevel": "100",
              "signalStrength": "100",
              "pendingChange": "False",
              "voltage": "3.24" 
          }
        ],
        "locationMessages":[
          {
              "deviceID":"10000" ,
              "locationMessageGUID":"5badfa3d-f110-4058-81cd-1ade90983adb",
              "locationDate":"2022-4-28 21:47:11",
              "state":"0",
              "latitude":"40.6977500915527",
              "longitude": "-111.894149780273",
              "altitude": "1302",
              "speed":"0",
              "course": "0",
              "fixTime": "24",
              "sateliteCount": "6",
              "uncertainty": "1"
          }
        ]
     }