The Wiser Cloud API is a dedicated service for Feller business partners aiming to develop innovative applications for the Wiser by Feller connected home platform. Currently, API access is available for heating controls, with plans to expand functionality in the future. As a partner, you have the opportunity to co-innovate with Wiser by Feller, shaping the future of smart living by creating new use cases and contribute to greener homes. End users retain full control over which third-party apps they authorize, with the ability to manage access settings at any time. To begin the process, please contact us with details about your project by emailing partner.api@feller.ch using the subject line: “Partner Access Request”. We will review your request and guide you through the next steps. You’re also welcome to share any feedback or proposals regarding the API by sending an email to this address. Please note that this service is exclusively available to Feller business partners and is not open to private individuals Terms of Use.

This documentation contains everything you need to integrate your application with the Wiser by Feller Cloud.

This guide is divided into two main sections:

1. Authentication. Before you can use the Wiser by Feller Cloud API, you must authenticate your requests. Once your application is approved, you will receive a unique client_id and client_secret. These credentials are required to obtain an access token, which is mandatory for all API calls.
   
   
2. API Documentation. This section offers in-depth details on all available API endpoints, including request methods, parameters, response codes, and sample payloads. We encourage you to explore the API documentation and discover the full potential of integrating with the Wiser by Feller Cloud. If you have any questions or need further assistance, please contact our team: partner.api@feller.ch

A Machine to Machine Application represents a program that interacts with an API where there is no user involved.

⚠️ Please note that the provided access_token is short-lived and will expire 2 hours after its creation. You will need to generate a new token after it expires.

You can execute a client credentials exchange to get an access token for Wiser By Feller cloud. Example in curl.

curl --request POST \
  --url https://id.feller.ch/oauth/token \
  --header 'content-type: application/json' \
  --data '{"client_id":"__________________________","client_secret":"__________________________","audience":"https://id.feller.ch/wiser-partners","grant_type":"client_credentials"}'

Response:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik9UTTBOa1JHUVRjM01FWXlPVU5GT1RZd1F6RXlSVGd6T0RaQ09EUkVRak5DT1RJME9EQTVOZyJ9.eyJpc3MiOiJodHRwczovL2ZlbGxlci5ldS5hdXRoMC5jb20vIiwic3ViIjoiWk9POEx5SkROdVZiakRveHhDZzJyQ0l2OU5VYTNCeXNAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vaWQuZmVsbGVyLmNoL3dpc2VyLXBhcnRuZXJzIiwiaWF0IjoxNzIxMjIwMjkxLCJleHAiOjE3MjEzMDY2OTEsImd0eSI6ImNsaWVudC1jcmVkZW50aWFscyIsImF6cCI6IlpPTzhMeUpETnVWYmpEb3h4Q2cyckNJdjlOVWEzQnlzIn0.lxko2VgQcPSNnaHBzBVSmtnbsgejrfT1RNHoojvdSurL0s3StDlbAUkKYUUar4jFtosaC5_f3t_rJXJHItCRczhVopPvxRwx_s9dTVI30htMqBgft9X41MkOWyqph49J8YO3DXxO68jadoV2XH7dgUdk1ri4-JGdGo7XOpkmPsWwCJNs8uM-9xB95LDU47Gmq7gAGX5cwmTEvrrCyCHV8_0qVRR0FBprWfkPfKfUBuERR-31HQWe_xsB9jO_S4jSFdIccT64MM29uG9zzsKvA0-M15IeEg5cCbmL3bqwlh5YsxfWAkEKxkQic7Y3_oTHDt0x0ePppMzDDIVXSa7lYA",
  "token_type": "Bearer"
}

That's it! Now that the application has an access_token, it is now able to make authorized calls to the API.

Example:

curl --request GET \
  --url https://user.nubes.feller.ch/api/partner/sites \
  --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik9UTTBOa1JHUVRjM01FWXlPVU5GT1RZd1F6RXlSVGd6T0RaQ09EUkVRak5DT1RJME9EQTVOZyJ9.eyJpc3MiOiJodHRwczovL2ZlbGxlci5ldS5hdXRoMC5jb20vIiwic3ViIjoiWk9POEx5SkROdVZiakRveHhDZzJyQ0l2OU5VYTNCeXNAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vaWQuZmVsbGVyLmNoL3dpc2VyLXBhcnRuZXJzIiwiaWF0IjoxNzIxMjIwMjkxLCJleHAiOjE3MjEzMDY2OTEsImd0eSI6ImNsaWVudC1jcmVkZW50aWFscyIsImF6cCI6IlpPTzhMeUpETnVWYmpEb3h4Q2cyckNJdjlOVWEzQnlzIn0.lxko2VgQcPSNnaHBzBVSmtnbsgejrfT1RNHoojvdSurL0s3StDlbAUkKYUUar4jFtosaC5_f3t_rJXJHItCRczhVopPvxRwx_s9dTVI30htMqBgft9X41MkOWyqph49J8YO3DXxO68jadoV2XH7dgUdk1ri4-JGdGo7XOpkmPsWwCJNs8uM-9xB95LDU47Gmq7gAGX5cwmTEvrrCyCHV8_0qVRR0FBprWfkPfKfUBuERR-31HQWe_xsB9jO_S4jSFdIccT64MM29uG9zzsKvA0-M15IeEg5cCbmL3bqwlh5YsxfWAkEKxkQic7Y3_oTHDt0x0ePppMzDDIVXSa7lYA'

• Site
  • Get all accessible sites
  • Get site details
• Heating Controls
  • Set the default boost temperature for a site
  • Set boost temperature for a hvac group
  • Set target temperature for a hvac group
  • Set desired valve position for a hvac group
• Application examples

A “site” refers to a single Wiser installation, such as a single family home or an apartment. When a user grants your application access through the Wiser Home App, that site becomes accessible. Each site can contain zero, one, or many “hvac groups,” which represent heating zones like a living room. These "hvac groups" are set up by the electrician during comissioning phase using the eSetup app.

Retrieve all accessible sites. Returns the site ID, its online status, and location.

• Path: https://user.nubes.feller.ch/api/partner/sites
• Method: GET

{
  "sites": [
    {
      "id": "bdeb2e4c-9531-4865- acb9- d912b30c277b",
      "online": true
      "gpl":"47.24497900 8.18521610"
    }
  ]
}

This endpoint provides all available information about the site.

• Path: https://user.nubes.feller.ch/api/partner/sites/{siteId}
• Method: GET

{
        "id": "4c788521-9001-4bdd-9287-0e9b544c411e",
        "online": true,
        "gpl":"47.24497900 8.18521610"
        "hvac": [
            {
                "id": 1,
                "ambientTemperature": 21.5,
                "targetTemperature": 25.5,
                "boost_temperature": 2,     
                "unit": "C",
                "thirdPartyEnabled": true
            },
            {
                "id": 2,
                "ambientTemperature": 21.5,
                "targetTemperature": 25.5,
                "boost_temperature": 2,     
                "unit": "C",
                "thirdPartyEnabled": true
             }
        ]
}

This set of endpoints allows external systems to control heating behavior within a Wiser installation ("site"). Each hvac group can be managed independently, including setting temperatures, valve positions, and boost levels. To maintain control over an hvac group, your system must call the relevant endpoint at least once every 15 minutes. If no update is received within this interval, the Wiser system will automatically resume control of the heating group to ensure consistent operation.

⚠️ The number of API requests is limited to 5 per minute per site.

This endpoint allows boosting all hvac groups by +2 °C relative to the user defined set points. Example. If the set points are 21 °C (as configured in the Home App) across all hvac groups, this endpoint will update the temperatures to 23 °C.

• Path: https://user.nubes.feller.ch/api/partner/sites/{siteId}/hvac/boost
• Method: PUT

{
  "enabled": true
}

This endpoint allows boosting individual hvac groups. The boost range is limited to –5 °C to +5 °C.

• Path: https://user.nubes.feller.ch/api/partner/sites/{siteId}/hvac/{hvacGroupId}/boost-temperature
• Method: PUT

{
  "value": 1
}

Set the desired temperature for a hvac group (room temperature setpoint) between +5 °C ... +30 °C. This endpoint also overrides any user-defined minimum or maximum temperature limits that may have been previously configured in the Home App.

• Path: https://user.nubes.feller.ch/api/partner/sites/{siteId}/hvac/{hvacGroupId}/target-temperature
• Method: PUT

{
  "value": 22.9
}

This endpoint allows setting the desired valve position for a given HVAC group. The position is expressed as an integer between 0 and 10000, representing approximation of the valve opening: 0 = closed, 5000 = 50 %, 10000 fully open).

• Path: https://user.nubes.feller.ch/api/partner/sites/{siteId}/hvac/{hvacGroupId}/valve-position
• Method: PUT

{
  "value": 10000
}