To explain the process, we will walk you through the use case of switching a relay of an Eltako Series 62 IP Relay via an ekey fingerprint scanner.
1: Installation and activation
Make sure that all the devices are ready for use and connected to your network.
The Eltako device can be added in the Eltako App as seen below. There you will find the IP-Adress.
2: Eltako API
To get started here is the Eltako API Beginners Guide. The use of the Postman App is recommended to run the full Eltako API, as shown in the Beginners Guide.
We want to switch an Eltako Series 62 relay, so we will just elaborate on the most relevant areas of the Eltako API. In the Postman you can load in every request you’ll need (method, URL, Headers, Body, Pre-request Script is all preset if you load it in that way).
API key
Device Information
With this key you now can send the first requests to gather information about your device.
The response should look something like this:
Switch Relay
With this information you can now set the request to switch a relay.
3: Test your request
If you followed the previous steps accordingly, you should be able to switch the specific relay of the Eltako device (Response as seen above in the previous two Screenshots). You can change the value from “on” to “off” if you want to open the relay.
4: ekey bionyx app
- Activate the HTTPS requests
- Add the Eltako HTTPS request
2.1 Make sure you choose the correct method and URL (same URL as in “Test your request”)
2.2 In the Request-Header you have to put in the API key for your Authorization, as seen below.
2.3 Now you put in the Request-Body (also same as in “Test your request”, bracket symbol necessary)
2.4 Regarding the saftey options I have selectes this format. Authentication won’t be nessecary as we are using the API key in the Request-Header
- Assign the HTTPS request
5: FINISH
As long as the fingerprint scanner can reach the Eltako device in the local network, the HTTPS request it sends will trigger the relay. An internet connection is not needed for daily use, but a stable local network is essential.
Important: Please note that, depending on the method, the data may be sent unencrypted in the home network. ekey does not accept any liability for consequences of any kind.