Zum Hauptinhalt springen

Erste Schritte mit Yggio-Apps

Erstellen Ihrer Anwendung​

Ihre Anwendung kann entweder ein eigenes Backend haben oder Yggio als Backend nutzen. Sie kann eine mobile Anwendung oder ein Webdienst sein.

Mit Yggio als Backend zu beginnen ist oft einfacher, da Sie so Yggios Benutzerverwaltung und Zugriffsrechte nutzen können, was die Entwicklung Ihrer Anwendung erheblich vereinfacht. In diesem Fall melden sich Benutzer mit ihren Yggio-Zugangsdaten bei Ihrer Anwendung an. Mit einem Low-Code-Entwicklungsframework und Yggio als Backend können Sie eine Anwendung in nur wenigen Wochen entwickeln.

Schnittstelle zu Yggio​

Ihre Anwendung wird mit zwei oder drei Komponenten von Yggio kommunizieren: der REST-API, der NGSI-API und dem Publisher.

  • Die REST-API und die NGSI-API können verwendet werden, um Entitäten abzurufen, zu erstellen, zu aktualisieren und zu löschen.
  • Die REST-API unterstützt außerdem Login, Zeitreihen, Benutzerverwaltung, Client-Anwendungen, Berichte, Regeln und vieles mehr.
  • Der Publisher ermöglicht es Ihrer Anwendung, Echtzeit-Push-Updates zu erhalten, wenn sich Entitäten ändern. Dafür muss Ihre Anwendung HTTP-POST-Anfragen verarbeiten oder den Yggio-MQTT-Broker abonnieren können. Weitere Informationen finden Sie auf der Publisher-Seite.

Ihre Anwendung kann auch Daten über HTTP POST, HTTP PUT, HTTP PATCH oder MQTT-Publish an Yggio senden.

Anwendungen mit eigenem Backend​

Verwendung des SDK​

Ihre Anwendung kann in jeder beliebigen Programmiersprache geschrieben werden. Wenn Sie sich jedoch für Node.js entscheiden, können Sie unser öffentliches SDK nutzen, das einsatzbereite Funktionen für die REST-API bietet. Weitere Informationen finden Sie auf der SDK-Seite.

OpenID Connect (OAuth 2.0)​

OpenID Connect wird verwendet, um Ihre Anwendung zu autorisieren, was ein Backend erfordert. Ihre Anwendung muss Unterstützung für OpenID Connect implementieren. Details finden Sie auf der OpenID-Connect-Seite.

Erstellen einer OAuth-2.0-Anwendung in Yggio​

New App

New OAuth 2.0 App

In Yggio wird eine Anwendung mit eigenem Backend als OpenID Connect Relying Party (RP) dargestellt. Um Ihre Anwendung mit Yggio zu verbinden, müssen Sie eine RP erstellen. Dies ermöglicht es Ihrer Anwendung, sich selbst mit OpenID Connect zu autorisieren, um die APIs zu nutzen und Updates vom Publisher zu erhalten.

Im APPS-Menü können Sie eine OAuth-Anwendung erstellen. Beim Erstellen der Anwendung erhalten Sie ein Client-Secret, das verwendet werden kann, um auf Yggio-Konten zuzugreifen, die Ihrer Anwendung Zugriff auf ihre Daten gewährt haben.

Anwendungen ohne eigenes Backend​

Anmeldung​

Wenn Ihre Anwendung Yggio als Backend nutzt, verwalten Sie Benutzer und ihre jeweiligen Zugriffsrechte über Yggios Organization Manager. Benutzer melden sich mit ihren Yggio-Zugangsdaten bei Ihrer Anwendung an und erhalten Zugriff auf dieselben Ressourcen (IoT-Nodes, Berichte usw.), die in ihren Yggio-Konten verfügbar sind. Um sich bei Yggio anzumelden, verwenden Sie den Endpunkt /auth/local, um ein Token zu erhalten, und verwenden Sie dieses Token dann, um auf andere APIs zuzugreifen.

Erstellen einer einfachen Anwendung in Yggio​

Im APPS-Menü können Sie eine einfache Anwendung erstellen. Geben Sie beim Erstellen der Anwendung eine URL zu Ihrer Anwendung an. Wenn Ihre Anwendung im Google Play Store oder Apple App Store veröffentlicht ist, können Sie den Web-Link angeben, damit Nutzer sie herunterladen und installieren können. Wenn Ihre Anwendung ein Webdienst ist, geben Sie einfach den Link zur Anwendung an.