Search
K

Quick Start: Erster API-Call

Willkommen im API Portal! In diesem Quick Start zeigen wir Ihnen, wie Sie Ihren ersten API-Aufruf mit dem Endpunkt /housingstock/flats durchführen. Weitere Endpunkte finden Sie, nach der Freischaltung, unter: ➡️ APIs

1. Access Token abrufen

Bevor Sie unsere APIs nutzen können, benötigen Sie ein gültiges Access Token. Bitte folgen Sie dazu der Anleitung unter: ➡️ Authentifizierung (Client Credentials Flow)

2. Erster API-Aufruf: /housingstock/flats

Sobald Sie Ihr Access Token haben, können Sie direkt den ersten API-Call ausführen. Verwenden Sie dazu den Authorization Header und geben Sie zusätzlich den Header x-customer: yuneo mit, um zu identifizieren zu welchem ERP System Sie sich verbinden.

Hinweis: Aktuell gibt es die Direkt Connect Anbindung ausschließlich für Wodis Yuneo

Beispiel (cURL)

curl -X GET "https://api.aareon.com/housingstock/flats" \
  -H "Authorization: Bearer <access_token>" \
  -H "x-customer: yuneo"

Beispiel (Python)

import requests

api_url = "https://api.aareon.com/housingstock/flats"
access_token = "<access_token>"  # hier das Token aus Schritt 1 einsetzen

headers = {
    "Authorization": "Bearer {access_token}",
    "x-customer": "yuneo"
}

response = requests.get(api_url, headers=headers)
print(response.json())

3. Ergebnis

Die Antwort liefert eine Liste der verfügbaren Wohnungseinheiten (flats).

✅ Damit haben Sie erfolgreich Ihren ersten Call an die API durchgeführt! Sie können nun weitere Endpunkte erkunden und die Daten in Ihre Anwendung integrieren.