Zum Hauptinhalt springen

API-Integration (Non-UI)

Mit einer Non-UI-Lizenz nutzt du die Funktionen eines Spaces der CASABLANCA Booking Engine ohne die mitgelieferte Benutzeroberfläche. Entwickler binden diese Funktionen über die Booking Engine API in eigene Anwendungen, Websites oder Partnersysteme ein und gestalten den Buchungsablauf selbst. Dazu benötigt der Betrieb einen API-Zugang.

Voraussetzungen​


  • Eine gültige Non-UI-Lizenz:
    • Basic (Non UI) – Schnittstellen-Lizenz für 1 Space, der nur einem Betrieb zugeordnet werden kann.
    • Ultimate (Non UI) – Schnittstellen-Lizenz für 1 Space, der mehreren Betrieben zugeordnet werden kann.
  • Ein Booking Engine Space, der in CASABLANCA angelegt ist.
  • Ein gültiger API-Zugang pro Betrieb.
Achtung

Für Non-UI-Anbindungen darf die Lizenz „Booking Engine“ bzw. Basic/Ultimate mit Benutzeroberfläche nicht verwendet werden.

→ Siehe Lizenzen

API-Zugang für Agenturen - Ablauf​


  1. Angebot: Der Betrieb erhält von CASABLANCA Sales ein Angebot für den API Access zur Booking Engine.
  2. AGB-Erweiterung: Die erweiterten AGB für den API Access sind Teil des Angebots und werden vom Betrieb unterschrieben. Sie regeln Zuständigkeit und Haftungsbegrenzung von CASABLANCA.
  3. API-Key: Nach der Unterschrift stellt CASABLANCA dem Betrieb den API-Key aus.
  4. Weitergabe: Der Betrieb gibt den API-Key selbst an die beauftragte Agentur weiter.
Wichtig

Ohne unterschriebene AGB-Erweiterung gibt CASABLANCA keinen API-Key aus.

Anbindungen​


Derzeit stehen folgende Anbindungen über die API zur Verfügung:

  • Re:Guest
  • SmartHost
  • NCM IQ Anfragemanager

→ Siehe Anbindungen

Space für die Anbindung anlegen​

Besitzt der Betrieb eine gültige Non-UI-Lizenz, kann in der CASABLANCA Booking Engine ein Space für eine Anbindung eingerichtet werden:

  1. Füge einen neuen Space hinzu.
  2. Navigiere zum Abschnitt Space Einstellungen.
  3. Konfiguriere folgende Felder:
    • Name – Bezeichnung des Spaces, zum Beispiel der Name der Anbindung.
    • URL-freundliche ID – Eine eindeutige, URL-kompatible Bezeichnung für den Space. Es sind nur Kleinbuchstaben erlaubt.

→ Siehe Space Einstellungen

Entwickler-Sandbox​


Für Tests steht eine Entwickler-Sandbox zur Verfügung. Sie arbeitet mit Testdaten, Produktivdaten des Betriebs sind davon nicht betroffen. Der Zugang zur Sandbox ist kein Self-Service. Er läuft über CASABLANCA, bei Agenturen über den Ansprechpartner, der den Zugang eingerichtet hat. Einen direkten Zugang zur CASABLANCA Cloud eines Betriebs kann ausschließlich der Betrieb selbst einrichten und freigeben.

Tipp

Aus Sicherheitsgründen werden keine Produktivdaten in Entwicklungsumgebungen übernommen. Die Sandbox lässt sich aber an die Stammdaten des Betriebs anpassen, also an Raten, Zimmerkategorien, Unternehmensangaben und Spaces. Dafür genügen IDs, Namen und Kapazitäten, die der Betrieb der Agentur zum Beispiel als Screenshot zur Verfügung stellen kann.

→ Siehe Developer Sandbox

Häufige Fragen​


Muss sich die Agentur zertifizieren lassen?

  • Nein. Eine Zertifizierung über das Partnerportal ist nur für Schnittstellenpartner vorgesehen. Eine Agentur, die im Auftrag eines Betriebs arbeitet, ist kein Schnittstellenpartner. Es gibt weder einen Partnervertrag mit der Agentur noch eine Zertifizierung.

Prüft CASABLANCA die Umsetzung der Agentur?

  • Nein. CASABLANCA nimmt die Lösung der Agentur weder ab noch prüft es sie. Für Umsetzung und Prüfung ist der Betrieb verantwortlich.

Wer entscheidet über die Weitergabe des API-Keys?

  • Ausschließlich der Betrieb. Der API-Key wird dem Betrieb ausgestellt, nicht der Agentur. Der Betrieb entscheidet, an welches Drittsystem er den Zugriff freigibt.

Unterstützt CASABLANCA beim Tracking (Google Analytics, Meta)?

  • Für die Einrichtung von Tracking- und Analytics-Lösungen auf der Website des Betriebs bietet CASABLANCA keinen Support an. Eine Anleitung steht unter Tracking.

Weitere Informationen​