The easiest way to get started as a developer on the LIVISI Home system is to use our Postman Collection . The collection already comes with client credentials to get you started fast. You will need your own LIVISI Home system to login. You can buy your own system on the Medion Webshop . To set up your system, start with the user account registration .

Just want to know what is possible? Check out the API Reference .

1. Setting up Postman

1. Download Postman on getpostman.com and install it
2. Open Postman
3. Download the LIVISI Postman Collection and Environment
4. Import the LIVISI Postman Collection and Environment

2. Authorize against your own system

In case of our Client API you are limited to the oAuth 2.0 Authorization Code Grant flow. In Postman there are multiple ways to do the Authorization Code Grant flow. We find the following way the easiest.

Copy the following URI to a browser of your choosing:

https://auth.services-smarthome.de/AUTH/authorize?response_type=code&client_id=54031115&lang=en-GB&redirect_uri=https%3A%2F%2Fdeveloper.services-smarthome.de%2Fauth

Now log in with your credentials:

After this you will be redirected to the proxy redirectURI https://developer.services-smarthome.de/auth. Go ahead and copy the request parameter code from the browser (fyi: it has a lifetime of 5 minutes):

and paste it in the LIVISI Postman Environment:

now send POST Token - Using code inside the folder Authorization:

This added a refreshToken as well as an accessToken to the Postman Environment. You are now ready to explore the API. Whenever the accessToken expires, just send Post Token - Using refresh token in the same folder to refresh it.

3. Send your first request

Go to Device and send GET - All Devices. This will let your retrieve all devices of your system. Including the hub, physical devices and other functional devices:

4. WebSocket Connection

Some request have an asynchronous response. In these cases you will have check incoming events via the WebSocket connection. Examples:

• Retrieving discovered devices
• Checking rather a state change action was successful (e.g. switching on a light).

Sadly Postman does not support WebSocket connections. However there are many clients that handle WebSocket connections. For example you can use the Chrome extension Simple WebSocket Client .

1. Copy the accessToken from the Postman Environment
2. Create the following string

wss://api.services-smarthome.de/API/1.1/events?token=<paste your accessToken here>

3. Paste it in the URL of Server Location and click OPEN:

You can read the incoming events in the Message Log area.