Skip to main content

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"
}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.