Hobby API

Hvad er hobby API?

Når du anvender hobby API, kan du nu også selv tilslutte smart løsninger til din Niko Home Control installation. Som kodekyndig bruger kan du få Niko Home Control til at fungere sammen med din egen applikation eller med løsninger som Node-RED, openHAB eller Home Assistant?

Niko og din professionelle installatør understøtter ikke de applikationer eller løsninger som du bygger med hobby API. For support henviser Niko til de fællesskaber, der er anført ovenfor.

Hvad kan du med Niko Home Control?

Når du anvender Niko Home Control sammen med hobby API, kan du gøre følgende:

• Hente dine tilgængelige Niko Home Control placeringer

• Hente dine tilgængelige Niko Home Control programmeringer og enheder

• Betjene dine Niko Home Control programmeringer og enheder

• Modtage statusoplysninger fra dine Niko Home Control programmeringer og enheder

• Modtage notifikationer fra din Niko Home Control installation

Du skal bruge:

	Kort sagt	Mere information
Generelt	Ekstra ledningsføring er ikke nødvendigt. Du har en computer med en webbrowser og en internetforbindelse. Du har kendskab til MQTT og JSON. Du er en avanceret kodekyndig bruger, og du har god ide.
	Dit Niko Home Control system opfylder følgende krav: Det har en trådløs smart hub eller en controller. Den er konfigureret med den seneste programmeringssoftware (version 2.17  eller nyere). Det har en aktiv internetforbindelse. Den er registreret, og du har din e-mailadresse og adgangskode ved hånden.	Hvis du ikke har registreret dit Niko Home Control system, gå til mynikohomecontrol.niko.eu.
	Hobby API'en er på din controller eller trådløse smart hub. Du har dit JWT API-adgangstoken.	Hvis du ikke har et token, anmod om det via Niko Home Control programmeringssoftwaren Mere information, se herunder. Adgangstokenet skal fornys årligt. Du finder fremgangsmåden nedenfor.

Hvordan får du adgang til hobby API (dokumentation og godkendelse)?

1. Sørg for, at du har alt det, du har brug for (se ovenfor).

2. Klik på Oversigt.
   

   

3. Klik på Administrer tilsluttede tjenester.
   

   

4. I sektionen Yderligere trin kræves klik på pilen ved siden af hobby API-logoet.
   

   

5. Klik på Administrer.
   

   

6. Indtast din e-mailadresse og Niko Home Control-adgangskode.

7. Klik på Accepter for at acceptere vilkår og betingelser.
   

   

8. Klik på Kopier for at hente tokenet og bruge det i din applikation.

9. Klik på Færdig.

• Du kan finde API-dokumentationen i aktiveringsvinduet.

• Du kan ikke ændre brugernavnet i aktiveringsvinduet.

Hvordan fornyer du dit adgangstoken?

Om adgangstokenet:

• Tokenet udløber efter et år.

• Tokenet skal fornys årligt.

• En fornyelse er tidligst mulig en måned, før den aktuelle udløbsdato.

• Du bliver ikke informeret af Niko om, at tokenet er ved at udløbe. Tip: Du kan oprette en notifikation i softwaren. Niko Home appen vil minde dig om at forny tokenet.

1. Sørg for, at du har alt det, du har brug for (se ovenfor).

2. Klik på Oversigt.
   

   

3. Klik på Administrer tilsluttede tjenester.
   

   

4. I sektionen Yderligere trin kræves klik på pilen ved siden af hobby API-logoet.
   

   

5. Klik på Administrer.
   

   

6. Følg instruktionerne på din skærm for at få et nyt token.