EXAMPLE: Switching a Shelly Plus 1

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.

1: Installation and activation

Make sure that all the devices are ready for 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:

  1. Open the Shelly app on your mobile phone.
  2. Select your device.
  3. 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

  1. Activate the HTTPS requests

  2. Add the Shelly HTTPS request
    2.1 Make sure you choose the correct method and URL:

  3. Assign the HTTPS request

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.