====== Integratie ======

Het Jullix energiebeheersysteem kan je ook integreren in andere omgevingen zoals een domotica omgeving bijvoorbeeld. Homeassistant is hiervan een voorbeeld. In deze wiki zal je informatie vinden hoe dit kan. De functionaliteit van het Jullix energiebeheer wordt voortdurend uitgebreid, deze informatie is daarom nog niet volledig maar zal ook regelmatig aangepast worden.

===== Wat kan je verwachten van dergelijke integratie? =====

Je zal in je domotica systeem gegevens van het Jullix energiebeheer kunnen weergeven. Zoals het actueel vermogen dat de zonnepanelen leveren, de kWh meter, de gasmeter stand enz. Je zal het energiebeheersysteem niet kunnen besturen.

===== Mogelijkheden =====

==== Platform-API ====

Een eerste mogelijkheid is via een platform-API. Dit gaat dan via het internet en met de authenticatie gegevens van het platform. In principe kan je alle data en functies die je ziet in de app of platform ook aanspreken via deze API. De documentatie hiervan vind je op [[https://mijn.jullix.be/apidocs/]]. De documentatie is nog niet volledig.

Authenticatie kan via de Autherization header samen met een token.

<code ->
Authorization: Bearer <token>
</code>

Deze token kan je aanmaken via het portaal, bij Profiel en API-tokens. Als je op de sleutel klikt dan krijg je de JWT token die je moet gebruiken in de HTTP header.

In [[nl:faq:homeassistant|HomeAssistant]] bijvoorbeeld kun je dan een sensor maken volgens: [[https://www.home-assistant.io/integrations/sensor.rest/]] \\


==== Jullix-direct ====

Een tweede mogelijkheid is directe communicatie met de Jullix, zonder internet. Hiervoor gaan we ervan uit dat de Jullix verbonden is aan een privénetwerk. Als je toegang hebt tot het prive netwerk heb je ook toegang tot de Jullix. Als je domotica systeem ook in het prive netwerk hangt kan die dus direct met de Jullix communiceren en bijvoorbeeld zonnepaneel data, digitale meter data enz. opvragen.\\

Hostname: jullix.local (gaat via mDNS) of het IP-address van de jullix\\  De volgende HTTP endpoints kunnen lokaal bereikt worden (geen authenticatie nodig):

  * /api/ems/meter
  * /api/ems/solar
  * /api/ems/battery
  * /api/ems/charger
  * /api/ems/plug


Via de directe toegang heb je natuurlijk alleen maar toegang tot realtime data. Voor andere data heb je de platform-API nodig. Je kan natuurlijk ook beide mogelijkheden combineren.