At aedifion, we firmly believe that any successful future building monitoring, analysis and control systems must be open. Such an open solution allows freely integrating, e.g., third party data sources, services, platforms, databases, output channels, and so forth. And, vice versa, it can also be integrated into third party services, platforms, databases, output channels and so forth.
The single most important feature of an open platform is a comprehensive, well-documented, free and open application programming interfaces (APIs). The aedifion.io platform provides such APIs to any customer.
This article provides a short overview of the APIs of the aedifion.io platform, their features and primary use cases.
All data and functionality offered by the aedifion.io platform can be accessed and manipulated through a RESTful HTTP API. This includes, e.g.,
importing, querying, and exporting time series data
creating and managing alerts on data and meta data
management of users, projects, datapoints, and access permissions
creating and managing all kinds of meta data such as tags, renamings, favorites, etc.
setpoint and schedule writing for active building control
The aedifion.io HTTP API is actively used in different places, e.g.,
the frontend (www.aedifion.io) interacts with the backend through the HTTP APIs
the Excel plugin pulls data from the HTTP API into Excel worksheets
the interactive 3D visualization uses the HTTP API to write setpoints
voice commands to Alexa trigger calls to the HTTP API to retrieve thermal comfort and to write setpoints
Most use cases of the aedifion.io platform center around collecting and acting upon time series data collected in buildings, plants, or whole districts. When such data should be streamed (in real time) in or out of the platform, the strict request/response pattern of HTTP APIs is often not the right choice. Thus, we complement the HTTP API by an MQTT API. MQTT follows a publish-subscribe model that provides convenient and efficient streaming access to live data. The features of the MQTT API include, e.g.,
subscribing to all measurement data collected from your buildings, plants, and districts at the level of whole projects or down to single datapoints
publishing data into the aedifion.io platform via MQTT
receiving to notifications and alarms via MQTT
The aedifion.io MQTT API is actively used in different places, e.g.,
by aedifion edge devices to send collected data and meta data to the aedifion.io platform
the interactive 3D visualization subscribes to live data via MQTT directly from within your browser using websockets
the aedifion.io platform publishes alarms created by the user on datapoints via MQTT
This documentation continues with an introduction of the aedifion beta frontend.