Welcome to Provisioning API’s documentation!

Energomonitor’s provisioning server is a database of all manufactured devices (Homebases, sensors, etc.) and their configuration. It is a web service with HTTP API available on URL provisioning.energomonitor.com.

Provisioning can remotely upgrade firmware, deactivate or change configuration in any device using common network protocols – HTTP and/or TFTP.

All HTTP endpoints are automatically redirected to HTTPS with certificate issued for energomonitor s.r.o..

Table of Contents

This documentation is divided into two sections: Cluster API and Homebase API.

The Cluster API contains endpoints useful for cluster servers – pair Homebase, get detailed information and get secret key stored in Homebase. All these endpoints requires cluster key as authentication method.

Seconds section, Homebase API is a brief description how Homebase communicates with provisioning.

• Cluster API
  • Cluster Registration
  • Authorization
  • Resources
• Homebase API
  • Resources

Terminology

There are several specific words used in this document.

• Homebase – physical device directly connected to the internet, gateway between sensors and server.

• Sensor – measures electricity, water, gas or any other medium. Sends data to Homebase via radio protocol.

• Cluster – any server with compatible input API where Homebase sends measured data.

• Serial number – unique 16 characters long serial number identifying Homebase.

• Pairing – assigning Homebase to cluster. When Homebase is paired, it starts to send data.