Hoppa till huvudinnehåll

Kom igång med Yggio Appar

Skapa din applikation​

Din applikation kan antingen ha en egen backend eller använda Yggio som backend. Den kan vara en mobilapplikation eller en webbservice.

Att börja med Yggio som din backend är ofta enklare, eftersom det låter dig utnyttja Yggios användarhantering och åtkomsträttigheter, vilket kraftigt förenklar utvecklingen av din applikation. I det här fallet loggar användarna in på din applikation med sina Yggio-inloggningsuppgifter. Med ett lågkodutvecklingsverktyg och Yggio som backend kan du utveckla en applikation på bara några veckor.

Interagera med Yggio​

Din applikation kommer att interagera med två eller tre komponenter av Yggio: REST API, NGSI API och Publisher.

  • REST API och NGSI API kan användas för att hämta, skapa, uppdatera och ta bort entiteter.
  • REST API stöder också inloggning, tidsserier, användarhantering, klientapplikationer, rapporter, regler och mycket mer.
  • Publisher låter din applikation ta emot realtidsuppdateringar när entiteter ändras. För detta behöver din applikation kunna hantera HTTP POST-förfrågningar eller prenumerera på Yggios MQTT-broker. För mer information, se Publisher-sidan.

Din applikation kan också publicera data till Yggio via HTTP POST, HTTP PUT, HTTP PATCH eller MQTT-publikation.

Appar med egen backend​

Använda SDK​

Din applikation kan skrivas i valfritt programmeringsspråk. Men om du väljer Node.js kan du utnyttja vår offentliga SDK, som erbjuder färdiga funktioner för REST API. För mer information, besök SDK-sidan.

OpenID Connect (OAuth 2.0)​

OpenID Connect används för att auktorisera din applikation, vilket kräver en backend. Din applikation måste implementera stöd för OpenID Connect. För detaljer, se OpenID Connect-sidan.

Skapa en OAuth 2.0-applikation i Yggio​

Ny App

Ny OAuth 2.0 App

I Yggio representeras en applikation med egen backend som en OpenID Connect Relying Party (RP). För att koppla din applikation till Yggio behöver du skapa en RP. Detta gör att din applikation kan auktorisera sig själv med OpenID Connect för att använda API:erna samt ta emot uppdateringar från Publisher.

I APPS-menyn kan du skapa en OAuth-applikation. När du skapar applikationen kommer du att få en klienthemlighet som kan användas för att få åtkomst till Yggio-konton som har gett din applikation tillgång till sina data.

Appar utan egen backend​

Inloggning​

Om din applikation använder Yggio som sin backend kommer du att hantera användare och deras respektive åtkomsträttigheter genom Yggios Organisation Manager. Användarna loggar in på din applikation med sina Yggio-referenser och får tillgång till samma resurser (IoT-noder, rapporter, etc.) som är tillgängliga i sina Yggio-konton. För att logga in på Yggio, använd slutpunkten /auth/local för att få en token, och använd sedan den token för att få åtkomst till andra API:er.

Skapa en grundläggande applikation i Yggio​

I APPS-menyn kan du skapa en grundläggande applikation. När du skapar applikationen behöver du ange en URL till din applikation. Om din applikation har publicerats på Google Play Store eller Apple App Store kan du ange webblänken för att användarna ska kunna ladda ner och installera den. Om din applikation är en webbservice anger du helt enkelt länken till applikationen.