To explain the process, we will walk you through the use case of switching the relay of a Shelly Plus 1 via an ekey fingerprint scanner.
Make sure that all the devices are ready for use and connected to your network.
In our sample we use the local Shelly API.
Please read the API documentation carefully to understand how it works.
We want to switch a Shelly relay, so we will just elaborate on the most relevant areas of the Shelly API.
As you can see on the screenshots above, the HTTP request has to be as follows:
The easiest way to find out the IP address of the Shelly device:
- Open the Shelly app on your mobile phone.
- Select your device.
- Go to “Settings” and “Device Information”. The IP address will be displayed.
Before setting up the HTTPS request in the ekey bionyx app, you can test the request in your browser. Type in the URL and press “Enter”. If the URL is correct and the Shelly device is reachable, the relay will switch.
If it doesn’t work, make sure that your devices are running in the same network!
Add the Shelly HTTPS request
2.1 Make sure you choose the correct method and URL:
As long as the fingerprint scanner can reach the Shelly device in the local network, the HTTPS request it sends will trigger the Shelly relay. An internet connection is not needed for daily use, but a stable local network is essential.
The Shelly API supports “on”, “off” and “toggle”. If you just need an impulse (e.g. for a garage door), there is an easy way to configure this in the Shelly app.