To explain the process and provide a practical example, we will walk you through the use case of switching the relay of a Shelly Plus 1 via an ekey fingerprint scanner.
1: Installation and activation
Make sure that all devices are ready to use and connected to your network.
2: Shelly API
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:
“http://Shelly-IP-Address/relay/0?turn=on”
or
“http://Shelly-IP-Address/relay/0?turn=toggle”
or
“http://Shelly-IP-Address/relay/0?turn=off”
Shelly IP ADDRESS
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.
3: Test your request
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!
4: ekey bionyx app
-
Add the Shelly HTTPS request
2.1 Make sure you choose the correct method and URL:
5: FINISH
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.
Additional information
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.
