Skip to content

Upcoming Changes in the API #10

Description

@benjamin4982

Hi,

there is an upcoming change to the API Url.

As far as i can see, this two lines should be changed in the module.php:
(/iot/v1/equipment --> /iot/v2/features)

private $installation_data_url = 'https://api.viessmann.com/iot/v2/features/installations?includeGateways=true';
private $device_data_url = 'https://api.viessmann.com/iot/v2/features/installations/%s/gateways/%s/devices/0/features/';

Important Update to Viessmann API (effective April 30, 2025)
We are announcing upcoming changes to the Viessmann API, effective April 30, 2025. These changes aim to improve the API's functionality and streamline the development process for our users.

API Endpoints Update

We are replacing several API endpoints with their current versions. This includes:

/iot/v1/equipment/installations/{installationId}/gateways/{gatewaySerial}/devices/{deviceId}/features replaced with /iot/v2/features/installations/{installationId}/gateways/{gatewaySerial}/devices/{deviceId}/features
/iot/v1/equipment/installations/{installationId}/gateways/{gatewaySerial}/features replaced with /iot/v2/features/installations/{installationId}/gateways/{gatewaySerial}/features
/iot/v1/equipment/installations/{installationId}/features replaced with /iot/v2/features/installations/{installationId}/features
/iot/v1/features replaced with /iot/v2/features
Important Notes:

The previous versions (/iot/v1/...) of the listed endpoints will be removed entirely on April 30, 2025. As a result, any existing integrations using these endpoints will cease to function.
The new endpoints (/iot/v2/...) function identically to their predecessors. There are no changes to the request parameters, response formats, or any other functional aspects.
Action Required

To ensure a smooth transition, we strongly recommend that you update your integrations to use the new API endpoints (/iot/v2/...) before April 30, 2025. The new endpoints are already available for use.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions