Quick Start

This quick start guide will help you to get familiar with the facilioo API.

What you'll need

Before you start make sure that you have got a valid facilioo account which consist of an email address and a password.

Environments

facilioo provides three environments. One for production and two for testing (development and staging). The staging environment includes the same data as production with 3-6 weeks old data, so you can use it for testing with real data. To access the development environment you need an account which you can get by sending us an email to [email protected].

The endpoints are:

production: https://api.facilioo.de/api (Web access via https://app.facilioo.de)

staging: https://stage-api.facilioo.de/api (Web access via https://stage-app.facilioo.de)

development: https://dev-api.facilioo.de/api (Web access via https://dev-app.facilioo.de)

You can find all endpoints in the API Reference by expanding "Base URL" as well.

Authorization

We are using access and refresh tokens to authentificate request on facilioo API. You can find all information about it here: https://developers.facilioo.de/reference/authentication

Performing the first request

As an example we want to get all properties for your facilioo account. To do that, we need the property section in the API Reference. Have a look at the following GO code:

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://staging-api.facilioo.de/api/properties"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Now you are ready to use the facilioo API. Happy coding!