Opinum Data Hub 6.5

Release date: 9 december 2024 in ODH EU

This last release of the year allows a new data integration (Ewon & more Elia Open Data), improve webhooks security, add more visibility to variables and fix bugs.

New Elia Open Data datasets

We've integrated more Elia Open Data datasets ( only in ODH EU):

Imbalance prices per minute (Near real-time)
System imbalance forecast next quarter hour (near real-time)
Wind power production estimation and forecast on Belgian grid (Near real-time)
Photovoltaic power production estimation and forecast on Belgian grid (Near real-time)

Tip

Find out how to get Elia Open Data datasets on your account

New device connector: Ewon

A new devices connector is available (only in ODH EU), you can now connect directly your Ewons in Data hub and retrieve automatically their data. The integration is available through a connector or though an API.

Tip

Discover how to connect your Ewons in Data Hub

Webhook sensitive data

We've added the “Secret” flag to headers. The effect of this flag is to declare a header value as sensitive, with the consequence that once the value has been saved in the API, it will no longer be possible to retrieve it. This same concept has been applied to the “password” authentication field.

As a result, from the moment you start using secret headers, you'll need to pay particular attention to how you apply modifications to them. The PUT is still available, but it requires the various secret values to be specified. These values are no longer available when retrieving a Webhook via the GET endpoint. We've therefore added a PATCH endpoint that must be used for all partial updates. The same principle applies to the test endpoint.

In parallel, webhook execution histories are now obfuscated to hide secret field values.

These changes have been made to enhance the platform's security and ensure that secret field values are not available to unauthorized users.

Tip

Learn more about webhooks

Variable group distribution

Variable groups have been added to other features:

All variables of a group can now be found in the API.
Variables groups are now available in the R code. We've also added the units and the tags.

Data ingestion dates

We have standardized the getsion of minimum and maximum ingestion dates in Data Hub. This development is transparent for customers.

We have updated the documentation to clarify ingestion and visualization limitations.

Tip

Learn more about limits

API changes

The new features developed in version 6.5 are available in APi without breaking change.

We have also published the supported versions of the API, which we will update with each release.

Tip

Discover the supported versions of the API

Webhooks
- New endpoint PATCH: /account/webhooks/{webhookId}
- Add optionnal secret flag to webhook header

[{
    "Id": "string",
    "AccountId": 0,
    "Name": "string",
    "ProviderType": "httpWebhook",
    "EventType": "alert",
    "Disabled": true,
    "FailedCount": 0,
    "Url": "string",
    "Headers": [
      {
        "Key": "string",
        "Value": "string",
        "Secret": true
      }
    ]
}, …]

Groups of variables

A new filter is added in the GetVariables to find variables according to their groups: https://api.opinum.com/swagger/index.html#/Variable/get_variables

Example of calls to find all variables of the group MyGroup: https://api.opinum.com/variables?Groups=MyGroup
This filter can be combien with the other filters available on GetVariables. For example to filter on a source with Id 123 and find variables that are in MyGroup1 OR in MyGroup2: https://api.opinum.com/variables?Groups=MyGroup1&Groups=MyGroup2

Bug fixes

Dashbaords
- Fix legend fields not selected when editing tiles.
- Fix the maximum value of a variable selected via its group that was not displayed in the scale/unit/expected value.
Sites: fix the export of GPS coordinates in the sites views export

Documentation Center