Open API

On this page you will find information and access to our Open API. This service has been made available for you to develop your own smart solution.

Terms of use

The material provided through the Ebeco Open API must not be used to distribute malicious code or in any way that could damage Ebeco's trademark. We also want you to specify Ebeco as the source.

Getting started

With the Ebeco API you can control the underfloor heating in all installations where the EB-Therm 500 thermostat together with the EB-Connect WiFi module is present.

To use our open API, do the following:

  1. Install the EB-Connect WiFi module in the EB-Therm 500 thermostat
  2. Select network and enter the password for your network in the thermostat
  3. Download Ebeco Connect from App Store or Google Play
  4. Follow the instructions in the app to create an account
  5. Use the documentation below to create your own service or app.
     

Technical specifications

Ebeco's API is a REST API that expects and returns JSON.

Limitations

There are no restrictions on the number of calls to our API. As a user, you register by installing the app. We assume that everyone who uses our open API follows our terms of use.

Authentication

Authentication to Ebeco's API is done using a Bearer Token which is acquired from /api/TokenAuth/Authenticate. Usernames and passwords are the same as used in the Ebeco Connect app. In the examples below we use Postman for requests.

The Abt.TenantId parameter should always be passed in the Header and set to 1.

Postman auth headers

Username and password is then sent as a POST request to /api/TokenAuth/Authenticate.

Postman get user list

The accessToken parameter returned in the response is then used to authenticate to the Ebeco API.
 
Example:
 

We send a GET request to /api/services/app/Devices/GetUserDevices and authenticate the header with "Bearer <accessToken>". A JSON list of the logged in user’s thermostats is returned.

For a complete reference of methods and parameters, please see our Swagger documentation located at ebecoconnect.com/swagger