rtuck99 / openhab-binding

OpenHAB Bindings for Viessmann and Glowmarkt APIs
Eclipse Public License 2.0
8 stars 3 forks source link

Migrate to new feature endpoints #35

Closed rtuck99 closed 1 year ago

rtuck99 commented 1 year ago

New Endpoint: FEATURES API

One of the most used endpoints of the Viessmann API are the "device features" and "gateway features" endpoints for retrieving the IoT features of your device or gateway. We now introduce new FEATURES API endpoints, which will replace the feature the device features and gateway features endpoints. Here you find the documentation for the new device features endpoint.

The URLs for the new features endpoints are:

Device features: https://api.viessmann.com/iot/v1/features/installations/{installationId}/gateways/{gatewaySerial}/devices/{deviceId}/features{?regex,filter}
Gateway features: https://api.viessmann.com/iot/v1/features/installations/{installationId}/gateways/{gatewaySerial}/features{?regex,filter}

Additionally, we now also provide an endpoint for features on installation level, which can be found here.

The new endpoints provide an easy way for filtering the response. You can use regular expressions or filter for a list of specific features.

The old endpoints are still available, but will be marked as deprecated. However, please make sure to switch to the new endpoints, as the plan is to remove the old endpoint.

rtuck99 commented 1 year ago

Fixed in 3.4.1