Zum Inhalt

APIs

√úberblick √ľber die APIs der aedifion.io Cloud-Plattform.

√úberblick

Wir bei aedifion sind der festen √úberzeugung, dass ein erfolgreiches zuk√ľnftiges Geb√§ude√ľberwachungs-, Analyse- und Steuerungssystem offen sein muss. Eine solche offene L√∂sung erlaubt es, z.B. Datenquellen, Dienste, Plattformen, Datenbanken, Ausgabekan√§le usw. von Dritten frei zu integrieren. Umgekehrt kann sie auch in Dienste, Plattformen, Datenbanken, Ausgabekan√§le usw. von Dritten integriert werden.

Das wichtigste Merkmal einer offenen Plattform ist eine umfassende, gut dokumentierte, freie und offene Programmierschnittstelle (engl. application programming interface, kurz API). Die aedifion.io Plattform bietet solche APIs f√ľr jeden Kunden an.

Dieser Artikel gibt einen kurzen √úberblick √ľber die APIs der aedifion.io Cloud-Plattform, ihre Funktionen und die wichtigsten Anwendungsf√§lle.

HTTP API

Alle Daten und Funktionen, die von der aedifion.io Plattform angeboten werden, k√∂nnen √ľber eine RESTful HTTP API angesprochen und manipuliert werden. Dies beinhaltet z.B. das

  • Importieren, Abfragen und Exportieren von Zeitreihendaten
  • Erstellen und Verwalten von Warnmeldungen zu Daten und Metadaten
  • Verwalten von Benutzern, Projekten, Datenpunkten und Zugriffsberechtigungen
  • Erstellen und Verwalten aller Arten von Metadaten wie Tags, Umbenennungen, Favoriten usw.
  • Schreiben von Sollwerten und Zeitpl√§nen f√ľr die aktive Geb√§udesteuerung
  • ...

Die aedifion.io HTTP API wird an verschiedenen Stellen aktiv genutzt, z.B.

  • interagiert das Frontend (www.aedifion.io) √ľber die HTTP-APIs mit dem Backend
  • l√§dt das Excel-Plugin Daten aus der HTTP-API in Excel-Tabellenbl√§tter
  • verwendet die interaktive 3D-Visualisierung die HTTP-API, um Sollwerte zu schreiben
  • l√∂sen Sprachbefehle an Alexa Aufrufe der HTTP-API aus, um den thermischen Komfort abzufragen und Sollwerte zu schreiben
  • ...

Noch mehr erfahren? Sehen Sie sich die schrittweisen Anleitungen zur Interaktion mit dieser API an oder erkunden Sie die zusätzlichen Entwickler-Ressourcen.

MQTT API

Die meisten Anwendungsfälle der aedifion.io Cloud-Plattform konzentrieren sich auf das Sammeln und Verarbeiten von Zeitreihendaten, die in Gebäuden, Anlagen oder ganzen Quartieren gesammelt werden. Wenn solche Daten (in Echtzeit) in oder aus der Plattform gestreamt werden sollen, ist das strenge Anfrage/Antwort-Muster der HTTP-APIs oft nicht die richtige Wahl. Daher ergänzen wir die HTTP-API durch eine MQTT-API. MQTT folgt einem Publish-Subscribe-Modell, das einen bequemen und effizienten Streaming-Zugang zu Live-Daten ermöglicht. Zu den Funktionen der MQTT-API gehören z.B.

  • das Abonnieren aller Messdaten, die von Ihren Geb√§uden, Anlagen und Quartieren gesammelt werden, auf der Ebene ganzer Projekte oder bis hin zu einzelnen Datenpunkten
  • die Ver√∂ffentlichung von Daten in der aedifion.io Cloud-Plattform √ľber MQTT
  • der Empfang von Benachrichtigungen und Alarmen √ľber MQTT
  • die Unterst√ľtzung von Websockets
  • ...

Die aedifion.io MQTT API wird an verschiedenen Stellen aktiv genutzt, z.B.

  • von aedifion's Edge Devices um gesammelte Daten und Metadaten an die aedifion.io Cloud-Plattform zu senden
  • abonniert die interaktive 3D-Visualisierung Live-Daten via MQTT direkt aus dem Browser √ľber Websockets
  • ver√∂ffentlicht die aedifion.io Cloud-Plattform vom Benutzer erstellte Alarme zu Datenpunkten via MQTT

Noch mehr erfahren? Sehen Sie sich die schrittweisen Anleitungen zur Interaktion mit der MQTT-API an oder erkunden Sie die zusätzlichen Entwickler-Ressourcen.


Letztes Update: 2022-02-14
Zur√ľck zum Seitenanfang