Skip to main content
On this page

Erster API-Call

Dieser Walkthrough bringt dich von null zu einer funktionierenden API-Antwort. Du brauchst zuerst nur eines: einen API-Key.

1. API-Key erstellen

API-Keys werden selbstständig in der etg24-App erstellt. Erstelle einen Key für deinen Agenten und kopiere ihn – er wird nur einmal angezeigt. Erstellung, Deaktivierung und Zuordnung sind in Key-Lebenszyklus erklärt.

2. Erste Anfrage senden

Die Property-Management-v2-API liegt unter https://api.etg24.de/propertymanagement/v2. Authentifiziere dich mit dem Header Authorization: Bearer <key>.

Wir listen die Kontakte deines Portals – eine reine Lese-Abfrage:

Terminal window
curl -s "https://api.etg24.de/propertymanagement/v2/query/contacts" \
  -H "Authorization: Bearer DEIN_API_KEY"

Das war’s. Du bekommst ein JSON-Payload mit einem pagination-Block und der contacts-Liste.

{
  "pagination": {"total": 12, "limit": 50, "offset": 0},
  "contacts": [{"id": "…", "firstName": "…", "lastName": "…"}]
}

3. Die Struktur der API verstehen

Jeder Endpoint ist entweder eine Query (liest Daten) oder ein Command (ändert Daten). Queries liegen unter /query/<type>, Commands unter /command/<type>:

GET  /propertymanagement/v2/query/contacts           Liste lesen
GET  /propertymanagement/v2/query/contacts.show      einen Kontakt lesen
POST /propertymanagement/v2/command/contacts.create  Kontakt anlegen

Das ist CQRS – dasselbe Prinzip, dem auch deine MCP-Tools folgen. Lies das CQRS-Konzept, um zu sehen, wie sich Read-only-Scopes darauf abbilden.

4. Die vollständige Referenz erkunden

Die komplette Endpoint-Referenz wird live aus der API generiert: Property Management v2. Python- und JavaScript-Beispiele findest du in der Snippet-Sammlung.

Häufige Fallstricke beim ersten Call

  • 401 – der Key fehlt, ist fehlerhaft oder deaktiviert. Header und Key-Status erneut prüfen.
  • 400 bei leeren Payloads – Commands brauchen einen JSON-Body; Queries brauchen nichts oder Filterparameter.
  • 403 bei einem Command – dein Key hat Read-only-Scope. Erstelle einen Key mit Schreibrechten, wenn du Daten ändern musst.