EXAMPLE: Switching a DoorBird intercom relay

To explain the process, we will walk you through the use case of switching the relay of a DoorBird intercom (D21x) 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: DoorBird API

In our sample we use the local Doorbird API.

Please read the API documentation carefully to understand how it works.

We want to switch a DoorBird relay, so we will just elaborate on the most relevant areas of the DoorBird API.


We recommend to use HTTP parameters and transfer the user ID and password directly in the URL.


The easiest way to find out the DoorBird IP address:

Use the online tool to find out the IP address:


Here we find the correct request to trigger the DoorBird intercom relay.

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 intercom is reachable, the relay will switch.

4: ekey bionyx app

  1. Activate the HTTPS requests
  2. Add the DoorBird HTTPS request
    2.1 Make sure you choose the correct method and URL (same URL as in “Test your request”)
  3. Assign the HTTPS request


As long as the fingerprint scanner can reach the DoorBird intercom in the local network, the HTTPS request it sends will trigger the DoorBird intercom 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.