Webhooks

The following events are monitored within Echolo’s IoT API and can generate Webhooks.

All callbacks are POST Requests.

Hub Hook

Each time the platform gets an update for a hub this event is triggered. The REST API equivalent to this is /hub.

Key	Trigger
hub_hook	A hub hook is fired every time a hub record is updated

Sample Payload

CODE

{
    "hubId": "99:88:44:44:EE:99",
    "appId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "lastSeenDate": "Mon Sep 11 07:50:06 2017"
}

Device Hook

When the platform receives an update for an end device from a hub this event is called. The REST API equivalent to this is /device.

Key	Trigger
device_hook	A device hook is fired every time a device record updated

Sample Payload

CODE

{
    "measuredDistance": "6",
    "appId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "rssi": "-69",
    "seenAt": "MyHubId",
    "rangeGuess": "3 8",
    "lastSeenDate": "Mon Sep 11 07:52:56 2017",
    "name": "(unknown)",
    "packet": "02010403039AFE17169AFE22585ECFA7007904B801000000022FE75D745E61",
    "nodeId": "99:11:88:CC:11:DD"
}

Device Position Hook

When the platform detects a position change for an end device this event is called. The REST API equivalent to this is /device.

Key	Trigger
device_position_hook	A device position hook is fired when the `seenAt` MAC does not match the old one

Sample Payload

CODE

{
    "measuredDistance": "6",
    "appId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "rssi": "-69",
    "seenAt": "MyHubId",
    "rangeGuess": "3 8",
    "lastSeenDate": "Mon Sep 11 07:52:56 2017",
    "name": "(unknown)",
    "packet": "02010403039AFE17169AFE22585ECFA7007904B801000000022FE75D745E61",
    "nodeId": "99:11:88:CC:11:DD"
}