Feller-AG / wiser-api

MIT License
14 stars 1 forks source link

Get the authentication code for Home Assistant integration #34

Open fabiogut84 opened 5 days ago

fabiogut84 commented 5 days ago

Dears,

i'm looking for additional help to integrate Wiser by Feller into Home Assistant, i found an integration prepared by Machgo that i installed on HA: https://github.com/machgo/fellerwiserhomeassistant

To proceed i need the host and apikey but with my little knowledge i don't know how to proceed using the following instruction: https://github.com/Feller-AG/wiser-tutorial/blob/main/doc/authentication.md

I stuck when i need to define the host: example.com and i'm not sure if as "user": "apiuser" i can define any type of sting.

Thank you

kinnkler commented 5 days ago

Hello,

for the Homeassistant integration you need the local IP address of the WLAN gateway for “host”. You also need an api-key so that the integration can control your installation via REST-API.

You generate the API key (secret) as follows:

  1. open the web interface of the Wiser gateway via the local IP address of the gateway and press Here at the bottom left to access the API.

    local_api
  2. go to Account and press “Try it out” at POST /api/account/claim.

    api_claim_try
  3. customize the request body with a desired user. e.g. “homeassistant”. Then press execute. You must then press a switch on the WLAN gateway within a certain time to confirm this. The gateway should flash pink during this time.

    api_claim_user
  4. as soon as you have pressed the button on the gateway, the request response appears. Copy the “secret” there.

    api_secret
  5. now paste this into the Homeassistant integration:

    ha_secret

Then everything should work. 😃

fabiogut84 commented 5 days ago

Many thanks! It works perfectly! So easy if you know how :-)