Straiv Workspace verbinden — API-Key holen und einfügen.
Diese Anleitung erklärt, wie Sie in Ihrem Straiv Workspace einen API-Key erzeugen, dessen Geltungsbereich (Scope) einstellen und den Key im StraivPMS-Workspace hinterlegen. Der Ablauf ist für alle zehn StraivPMS-Module identisch. Sie brauchen dafür einen aktiven Straiv-Vertrag und Administrator-Rechte in Ihrem Straiv-Konto.
Schritt 1 — Straiv Workspace öffnen
Melden Sie sich mit Ihren Straiv-Zugangsdaten in Ihrem Straiv Workspace an. Die Anmeldung erfolgt direkt bei der Straiv GmbH — StraivPMS hat weder Zugriff auf noch Kenntnis von Ihrem Straiv-Passwort. Sollten Sie Ihre Zugangsdaten vergessen haben, verwenden Sie den Passwort-vergessen-Ablauf Ihres Straiv-Anbieters.
Schritt 2 — API-Bereich aufrufen
In Ihrem Straiv Workspace finden Sie den API-Bereich in der Regel unter „Einstellungen → Integrationen → API-Keys". Der Menüpunkt heißt je nach Version Ihres Straiv-Kontos leicht anders. Falls Sie den Punkt nicht sehen, prüfen Sie, ob Ihr Benutzer die Rolle „Administrator" hat — in anderen Rollen ist der API-Bereich in vielen Straiv-Konten ausgeblendet.
Schritt 3 — Neuen API-Key erzeugen
Klicken Sie auf „Neuen API-Key erzeugen". Vergeben Sie einen sprechenden Namen, etwa „StraivPMS — Modul Meldescheine". Beim Geltungsbereich (Scope) wählen Sie die Rechte, die das jeweilige StraivPMS-Modul benötigt. Die notwendigen Scopes finden Sie in der jeweiligen Modul-Beschreibung im StraivPMS-Katalog. In der Regel reichen Lese-Rechte auf Reservierungen, Gäste und Zimmer sowie Schreib-Rechte auf einige wenige Meta-Felder aus.
Schritt 4 — API-Key kopieren
Der API-Key wird Ihnen einmal im Klartext angezeigt. Kopieren Sie den Key sofort — er lässt sich später nicht erneut anzeigen. Notieren Sie den Key nirgendwo dauerhaft, sondern gehen Sie unmittelbar zu Schritt 5. Sollten Sie den Key versehentlich verlieren, erzeugen Sie einen neuen und widerrufen den alten.
Schritt 5 — Im StraivPMS-Workspace einfügen
Öffnen Sie Ihren StraivPMS-Workspace über den Zugangs-Link aus der Bestellbestätigungs-E-Mail. Wählen Sie das bestellte Modul aus der Übersicht aus und klicken Sie auf „Straiv verbinden". Fügen Sie den kopierten API-Key ein und bestätigen Sie die Verbindung. Der Workspace prüft den Key, liest Ihre Objekte, Zimmerkategorien und Raten und legt entsprechende Konfigurations-Vorschläge an. Nach Freigabe der Vorschläge synchronisiert sich das Modul mit Ihrem Straiv-Konto — die erste Live-Wirkung folgt binnen 15 Minuten.
Schritt 6 — Verbindung überwachen
Der StraivPMS-Workspace zeigt den Status Ihrer Straiv-API-Verbindung fortlaufend an. Wenn Straiv-seitig Änderungen an Ihrem API-Key (etwa ein Widerruf oder Scope-Änderung) vorgenommen werden, sehen Sie dies unmittelbar. Sie können Alarm-E-Mails an eine oder mehrere Adressen Ihres Hauses aktivieren, damit Sie über etwaige Verbindungs-Probleme frühzeitig informiert werden.
Häufige Fragen
Kann StraivPMS mit meinem Straiv-Passwort etwas anfangen?
Nein. StraivPMS sieht Ihr Straiv-Passwort nie. Die Verbindung erfolgt ausschließlich über den von Ihnen erzeugten API-Key mit dem von Ihnen festgelegten Scope. Sie können den Key jederzeit im Straiv Workspace widerrufen.
Was passiert, wenn ich den API-Key im Straiv Workspace lösche?
Das StraivPMS-Modul verliert unmittelbar die Verbindung. Sie können im StraivPMS-Workspace einen neuen Key einfügen. Es entstehen keine Datenverluste — die im StraivPMS bereits verarbeiteten Daten bleiben nach Ihren Aufbewahrungs-Regeln erhalten.
Wie kann ich den Scope eines API-Keys einschränken?
Im Straiv Workspace unter „Einstellungen → Integrationen → API-Keys" wählen Sie den betreffenden Key und passen die freigegebenen Rechte an. Der StraivPMS-Workspace zeigt Ihnen an, wenn ein Modul aufgrund fehlender Rechte nicht wie vorgesehen arbeiten kann.