Daten-API: Schlüssel, Zugriff und Dokumentation

Für Anbindungen an Buchhaltung, eigene Tools oder Partnersysteme bietet Xentra eine öffentliche REST-API, ausgehende Webhooks und einen MCP-Server für KI-Assistenten.

Wo einrichten

Integrationen → API / MCP (API / MCP öffnen); dieselbe Seite steht auch unter Einstellungen → API / MCP. Oben findest du die Adresse der API (rest.myxentra.com) und „Vollständige Referenz öffnen“, darunter die KI-Anbindung (siehe Claude oder ChatGPT mit Xentra verbinden (MCP)), die Unit-IDs und die Reiter API-Keys und Webhooks.

Die Seite API / MCP unter Integrationen

Wer das darf

Nur dein Hauptzugang und deine Team-Admins. Für andere Teammitglieder ist das kein Recht, das du im Rechte-Raster vergeben kannst; der Bereich ist für sie ausgeblendet, weil ein API-Schlüssel für das ganze Konto handelt. Neue Schlüssel und Webhooks legst du nur mit aktivem Abo an, in der kostenlosen Testphase ohne Zahlungsart geht das noch nicht. Bestehende Schlüssel und Webhooks bleiben gültig.

API-Schlüssel anlegen

Im Reiter API-Keys auf „Neuer Key“ klicken.
Einen Namen vergeben (zum Beispiel den des Programms, das ihn nutzt), die Gültigkeit und die Rechte wählen.
Erstellen. Der Schlüssel beginnt mit xtr_live_ und wird nur einmal angezeigt: sofort sicher speichern. Später siehst du nur noch Namen und die letzten vier Zeichen.

Rechte: Du legst je Bereich fest, was der Schlüssel darf (Aus, Lesen oder Lesen und schreiben); am Anfang ist alles aus. Gastdaten, Nachrichten an Gäste, Rechnungen und der Zugang (Türcode, Türlinks, Check-in-Link, WLAN-Passwort) sind eigene Häkchen. Fehlt ein Recht, bleiben diese Felder leer oder die API antwortet mit 403. Nachträglich ändern lassen sich die Rechte nicht; leg dafür einen neuen Schlüssel an. Gültigkeit: 90 Tage, 1 Jahr (empfohlen) oder unbegrenzt. Alles dazu, auch Rotieren und Erneuern: siehe API-Key: Rechte, Gültigkeit, Rotieren.

In der Liste siehst du bei jedem Schlüssel seine Rechte, das Limit, wann er zuletzt benutzt wurde, seinen Status und über das Uhr-Symbol („Aufrufe ansehen“) seine letzten 50 Aufrufe mit Route, Status und Dauer. „Widerrufen“ sperrt einen einzelnen Schlüssel ab dem nächsten Aufruf, ohne die anderen zu berühren. Leg am besten je Anbindung einen eigenen Schlüssel an.

Ein erster Aufruf

curl https://rest.myxentra.com/api/v1/bookings/ \
  -H 'Api-Key: xtr_live_...'

Den Schlüssel schickst du immer im Header Api-Key, ohne „Bearer“ davor. Authorization: Bearer funktioniert nur beim MCP-Server. Lehnt die API einen Aufruf mit 401 ab, steht im Feld detail der Antwort, woran es liegt: Der Schlüssel fehlt, steht im falschen Header oder wurde nicht angenommen (vertippt, widerrufen oder abgelaufen). Geht ein Schlüssel, der eben noch funktioniert hat, plötzlich nicht mehr, versuch es zuerst noch einmal, bevor du einen neuen anlegst.

Die vollständige Dokumentation mit allen Endpunkten und Feldern liegt unter https://rest.myxentra.com/docs.

Wo finde ich die Unit-ID einer Einheit?

Auf der Seite API / MCP den Bereich „Deine Units“ aufklappen (er ist anfangs zugeklappt). Die Tabelle zeigt jede Einheit mit Namen und Unit-ID, ein Klick auf das Symbol daneben kopiert die ID. Programmatisch bekommst du sie über GET /api/v1/properties/get-user-properties.

Was die API kann

Buchungen und Blockierungen (lesen, anlegen, ändern, stornieren), Einheiten (mit Beschreibung, maximaler Gästezahl und der Hausordnung aus deinem Online-Check-in), Preise, Mindestaufenthalt und Verfügbarkeit, Gästerechnungen (mit PDF und E-Rechnungs-XML), Extras auf eine Buchung setzen und die Rechnung ausstellen, Produkte, Versicherung, Gästenachrichten und die Verwaltung der Webhooks. Die Einzelheiten stehen in eigenen Artikeln:

Daten-API: Buchungen anlegen, ändern und auslesen
Extras auf eine Buchung setzen und die Rechnung über die API ausstellen
Daten-API: Gästenachrichten lesen und senden
Blockierungen über die Daten-API lesen und setzen
Preis-API: Preise, Mindestaufenthalt und Verfügbarkeit über die API
Webhooks: Ereignisse, Felder und Signatur
Daten-API: Limits, 403-Sperre und richtig synchronisieren

Portale, die deine Unterkünfte über die API verkaufen (zum Beispiel Travanto), holen deine Preise samt Aufschlag für das Portal, deine Preisregeln, deine Zusatzleistungen aus dem Buchungstool und die Daten deiner Unterkünfte (Schlafzimmer, Betten, Bäder, Bilder). Ihre Buchungen kommen mit dem Portal als Quelle und mit der Provision an. Den Aufschlag legst du selbst fest: siehe Aufschlag für Travanto.

Wo Änderungen an der API angekündigt werden

Einen eigenen E-Mail-Verteiler für API-Änderungen gibt es nicht. Produktänderungen stehen im Changelog in der Seitenleiste, der aktuelle Stand der Endpunkte in der Dokumentation unter https://rest.myxentra.com/docs.