Skip to content

Upcoming Changes in the API #10

@benjamin4982

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.

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