Echolo

The Echolo Developer Hub

Welcome to the Echolo developer hub. You'll find comprehensive guides and documentation to help you start working with Echolo's IoT Platform as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Webhook Events Types

The following events are monitored within Echolo and can generate Webhooks:

Callbacks to URL's

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

{
    "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

{
    "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

{
    "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"
}