API-Zugang — Smoobu und SmoobuPMS verbinden

Voraussetzung: aktive API-Freigabe in Smoobu

Damit unsere Module Daten aus Ihrem Smoobu-Kundenbereich lesen und dorthin schreiben können, muss die API-Freigabe in Smoobu aktiviert sein. Diese Freigabe ist in allen Smoobu-Tarifen enthalten, muss aber gegebenenfalls manuell eingeschaltet werden.

Vorgehen im Smoobu-Kundenbereich:

Anmelden bei Smoobu unter smoobu.com
Öffnen von «Einstellungen → API» im Menü
Aktivierung der «Public API» durch Setzen des Schalters
Kopieren Sie NICHT den API-Key — dieser wird nicht benötigt (wir verwenden OAuth2, siehe unten)

OAuth2-Autorisierung des SmoobuPMS-Moduls

Nach Bestellung eines SmoobuPMS-Moduls erhalten Sie eine Aktivierungs-E-Mail mit einem Autorisierungs-Link. Dieser Link führt Sie durch den folgenden Ablauf:

Klick auf den Autorisierungs-Link in der E-Mail
Weiterleitung zur Smoobu-Anmeldeseite (Sie erkennen die smoobu.com-URL in der Adressleiste)
Anmeldung mit Ihren Smoobu-Zugangsdaten (Passwort geht NICHT an SmoobuPMS)
Smoobu zeigt Ihnen die vom Modul angeforderten Berechtigungen und fragt Ihre Zustimmung ab
Bei Zustimmung leitet Smoobu Sie zurück zum SmoobuPMS-Kundenbereich mit einem OAuth2-Access-Token
SmoobuPMS speichert den Token verschlüsselt und beginnt mit der Synchronisation

Widerruf der Autorisierung

Sie können die Autorisierung jederzeit widerrufen. Zwei Wege:

Über Smoobu: In Ihrem Smoobu-Kundenbereich unter «Einstellungen → Verbundene Anwendungen» finden Sie eine Liste aller autorisierten Drittanbieter. Klick auf «Widerrufen» beendet die Verbindung sofort.

Über SmoobuPMS: In Ihrem SmoobuPMS-Kundenbereich unter «Aktive Module» wählen Sie das entsprechende Modul und klicken «Deaktivieren». Die Autorisierung wird dann synchron auch bei Smoobu widerrufen.

Verwendete API-Endpunkte

Je nach Modul verwenden wir unterschiedliche Endpunkte der Smoobu-API:

Read-only Endpunkte: Buchungen (bookings), Objekte (apartments), Verfügbarkeiten (availabilities), Preise (rates), Nachrichten (messages)
Read/Write Endpunkte: Preise (rates), Verfügbarkeiten (availabilities), Blockierungen (blocks), Nachrichten (messages)

Welche Endpunkte ein konkretes Modul verwendet, erfahren Sie beim Autorisierungs-Ablauf und dauerhaft im Kundenbereich unter «Aktive Module → Details → API-Berechtigungen».

API-Log

Alle API-Aufrufe zwischen unseren Modulen und Ihrem Smoobu-Kundenbereich werden protokolliert und in Ihrem SmoobuPMS-Kundenbereich für 30 Tage einsehbar. So können Sie jederzeit nachvollziehen, welche Daten wann gelesen oder geschrieben wurden.