General information

There are events for energy devices that trigger streaming messages. Receiving event-based data is useful for handling asynchronous events, such as commands, and ensuring that your system stays up to date with the latest device information. The Energy Hub Alliance will ensure automatically that vendor data is always up to date.

We recommend using streaming instead of API polling to avoid delays and reduce unnecessary traffic.

In case you feel that data of a device might be outdated, a data update can be requested manually. This function is triggered by calling e.g. Refresh vehicle data. In addition to the response of the API-request, this will also trigger a streaming message, if the device can be reached. The refresh endpoints should be used with caution, as it might trigger too many requests to the vendor API when used too excessively.

Message format

Kafka messages send to your Kafka Broker have the following format:

{subscriptionId}.{deviceType}.{eventType}

The subscriptionId is the ID of your subscription created in the partner portal. The deviceType is the type of the connected device or object, for example a vehicle, tariff, HVAC or home energy device. The eventType is the action related to the message and described in more details below.

Supported event types

There are three main events types supported by the streaming service.

Connect

Notifies if a new device has been connected to the Energy Hub Alliance.

Update

Sends the newest data of a device, when at least one data model property has changed. Use this event to recieve the latest device data.

Delete

Notifies if a new device has been deleted from the Energy Hub by the end-user or the partner.

Offline

Notifies if a device has not been reachable for some time from and went offline.

Command

Notifies about the creation and status of a command.