Webhooks provide a way for our system to push information about an event that has occurred within an Echolo managed IoT network to you. A webhook is like an inverted API endpoint; instead of making a call to our API, you define a callback URL to which we will HTTP POST information to when an event happens in our system. Your callback URL can then execute code based on the POSTs. You can think of it as defining an API endpoint in your app that will receive output from Echolo.

Caveats

Keep in mind that your servers need to be robust enough to handle a large number of requests from Echolo's webhooks, especially if your network has many active Hubs and Devices.

Setup

Creating and managing webhook subscriptions is performed by making API requests to Webhook Resource endpoints.

You can implement basic HTTP authentication in your callback endpoint by providing credentials in webhook URL parameter. Below is an example of the post url with authentication included.

http(s)://username:[email protected]/foo.php