Escape Room Partnerportal

Nehmen Sie Buchungen für Ihren Escape Room über den österreichischen Escape-Room-Aggregator entgegen.

Listen Sie Ihren Escape Room auf escaperooms.at

Keine monatliche Gebühr und keine Einrichtungskosten. Sie zahlen eine Provision nur für bestätigte Buchungen.

Partnerkonto erstellen Anmelden

So funktioniert die Partnerschaft

Sie zahlen nur für bestätigte Buchungen

There is no monthly fee and no cost to list a room. Commission is 15% of the booking value, charged per confirmed booking, and empty slots cost you nothing. Your balance, commissions and invoices are visible in the partner portal at any time.

Wenn Sie Buchungen über einen Promo-Link auf Ihrer eigenen Website entgegennehmen, zählen wir die von uns gesendeten Klicks und rechnen die Provision aus den von Ihnen gemeldeten Buchungen ab. Klicks selbst werden nie berechnet.

Drei Wege zur Anbindung

Binden Sie Ihr eigenes Buchungssystem über unsere API an, betten Sie das Buchungs-Widget auf Ihrer Website ein oder nutzen Sie einfach einen getrackten Promo-Link. Die Methode können Sie später in den Integrationseinstellungen wechseln.

Verfügbarkeit bleibt synchron

Bei API-Räumen rufen wir Ihren Zeitplan automatisch ab, damit die angezeigten Slots Ihrem eigenen System entsprechen. Hier getätigte Buchungen werden direkt an Sie weitergeleitet.

4 Räume heute gelistet
1 abgedeckte Städte
DE / EN Sprachen, in denen Ihr Eintrag erscheint

Erstellen Sie Ihr Partnerkonto

Integrationsdokumentation

Wählen Sie Ihre Integrationsmethode

Es gibt drei Wege, Ihre Escape-Room-Buchungen mit unserer Plattform zu verbinden:

  • API-Integration (Empfohlen): Bietet Echtzeit-Verfügbarkeit und direkte Buchungsmöglichkeiten. Erforderttechnische Einrichtung Ihrerseits.
  • Promo-Code-Link: Einfache Einrichtung. Wir leiten Benutzer mit einem eindeutigen Code auf IhreWebsite weiter. Sie melden uns regelmäßig bestätigte Buchungen zurück.
  • Buchungsdetails Binden Sie ein fertiges Buchungs-Widget auf Ihrer Website ein. Besucher buchen direkt vor Ort auf der Seite.

Sie können Ihre bevorzugte Methode bei der Registrierung Ihres Raums auswählenoder später in den Integrationseinstellungen ändern.

API-Dokumentation

Sie benötigen vier Endpunkte auf Ihrer Seite: Slots auflisten, einen Slot prüfen, buchen und stornieren. Wenn Sie kein technischer Experte sind, führt unser Support-Team Ihren Entwickler gerne durch die Einrichtung.

Authentifizierung
Authorization: Token YOUR_API_TOKEN
CORS-Konfiguration
Wichtig: Aktivieren Sie CORS auf Ihrem Server

Sie müssen Ihren API-Server so konfigurieren, dass Cross-Origin-Anfragen vonunserer Domain zugelassen werden. Andernfalls schlägt der API-Verbindungstestmit einem Fehler wie dem folgenden fehl:

Failed to load resource: Origin not allowed by Access-Control-Allow-Origin

So aktivieren Sie CORS:

  • Fügen Sie die folgenden Header zu Ihren API-Antworten hinzu:
    • Access-Control-Allow-Origin: https://escaperooms.at
Access-Control-Allow-Methods: GET, PATCH, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
  • Wenn Sie eine lokale Umgebung zum Testen verwenden, müssen Sie möglicherweiseFolgendes hinzufügen: Access-Control-Allow-Origin: http://localhost:8000
  • Spezifische Anweisungen finden Sie in der Dokumentation Ihres Webservers:
Erforderliche API-Endpunkte
GET /{questId}/timeslots

Gibt verfügbare Zeitfenster zurück.

Antwortformat:
[
  {
    "timestamp": 1444435200, // Unix timestamp in seconds
    "available": true,
    "price": 300
  },
  {
    "timestamp": 1444435200,
    "available": false,
    "price": 300
  },
  {
    "timeGame": "1444435200", // Alternative field name
    "available": true,
    "price": 700
  }
]
GET /{questId}/timeslots/{timestamp}

Überprüft, ob ein bestimmter Zeitfenster verfügbar ist.

Antwortformat:
{
  "available": true,
  "price": 200
}
PATCH /{questId}/timeslots/{timestamp}

Bucht einen bestimmten Zeitfenster.

Anfrageformat:
{
  "username": "John",
  "phone": "+380501234567",
  "email": "email@mail.com",
  "comment": "Good quest",
  "fullPrice": 1000,
  "discount": 20,
  "discountPrice": 800,
  "discountCardNumber": "a1234",
  "giftCertificateNumber": "X987D5243",
  "stock": "",
  "countPlayers": 4
}
PATCH /{questId}/timeslots/{timestamp}/cancel

Storniert eine Buchung für einen bestimmten Zeitfenster.

Antwortformat:
{
  "success": true
}
Benötigen Sie Hilfe bei der Integration?

Unser technisches Team steht Ihnen bei Ihrer API-Integration zur Verfügung.Wir können Ihnen helfen, diese Endpunkte zu implementieren undsicherzustellen, dass Ihr System nahtlos mit unserer Plattformzusammenarbeitet.

Kontaktieren Sie uns unter hello@escaperooms.at

Einbettbares Buchungs-Widget

Online-Buchung zu Ihrer Website hinzufügen

Binden Sie unser Buchungs-Widget direkt auf Ihrer Website ein. Ihre Besucher können verfügbare Zeitfenster durchsuchen und buchen, ohne Ihre Seite zu verlassen. Das Widget synchronisiert sich automatisch mit Ihrem Zeitplan auf unserer Plattform.

So funktioniert's
1. Widget aktivieren

Bitten Sie Ihren Account Manager, das Widget für Ihren Raum zu aktivieren, oder aktivieren Sie es im Admin-Bereich.

2. Einbettungscode kopieren

Kopieren Sie das folgende iframe-Snippet und fügen Sie es in das HTML Ihrer Website ein.

Beginnen Sie, Buchungen zu erhalten!

Besucher buchen direkt auf Ihrer Website. Sie erhalten Benachrichtigungen und sehen Buchungen in Ihrem Dashboard.

Einbettungscode

Kopieren Sie den folgenden Code und fügen Sie ihn dort ein, wo das Buchungs-Widget auf Ihrer Website erscheinen soll:

<iframe
  src="https://escaperooms.at/widget/YOUR_ROOM_UUID/"
  width="100%"
  height="700"
  frameborder="0"
  style="border:none; border-radius:8px;"
></iframe>

Ersetzen Sie YOUR_ROOM_UUID durch die eindeutige ID Ihres Raums. Sie finden diese nach der Registrierung in Ihrem Partner-Dashboard.

Anpassungsoptionen

Sie können das Erscheinungsbild des Widgets per URL-Parameter anpassen:

Parameter Beschreibung Beispiel
lang Widget-Sprache. Unterstützt: de (Deutsch), en (Englisch). Standard: de ?lang=en
color Akzentfarbe als Hex-Code (ohne #). Wird für Buttons und Hervorhebungen verwendet. ?color=ff5733
Beispiel mit benutzerdefinierter Sprache und Farbe:
<iframe
  src="https://escaperooms.at/widget/YOUR_ROOM_UUID/?lang=en&color=28a745"
  width="100%"
  height="700"
  frameborder="0"
></iframe>
Widget-Funktionen
  • Wöchentliche Zeitplanansicht mit Navigation zwischen den Wochen
  • Echtzeit-Verfügbarkeit — gebuchte Zeitfenster werden automatisch ausgegraut
  • Integriertes Buchungsformular mit Validierung
  • Buchungsbestätigung wird direkt im Widget angezeigt
  • Mobiles responsives Design — funktioniert auf Smartphones, Tablets und Desktops
  • Spam-Schutz über Honeypot-Feld
  • Anpassbare Akzentfarbe passend zu Ihrer Marke
  • Unterstützt Deutsch und Englisch
Details anzeigen
  • Das Widget wird als eigenständige HTML-Seite bereitgestellt und ist für die Einbettung per iframe ausgelegt
  • Es verwendet Bootstrap 5 und jQuery (über CDN geladen, ohne Konflikte mit Ihrer Website)
  • Zeitplandaten werden über unsere API geladen: GET /api/room/{room_id}/schedule/?date=YYYY-MM-DD
  • Buchungen werden per POST an /widget/{room_id}/book/ als JSON übermittelt
  • Der CSRF-Schutz wird über ein sicheres Widget-Token umgesetzt
  • Das Widget setzt X-Frame-Options so, dass die Einbettung auf jeder Domain möglich ist
Voraussetzungen
  • Das Widget muss für Ihren Raum aktiviert sein (widget_enabled = true)
  • Für Ihren Raum müssen auf unserer Plattform Zeitpläne (Zeitfenster) konfiguriert sein
  • Buchungen über das Widget werden in Ihrem Dashboard mit der Quelle 'WIDGET' markiert
Partner-Support

Unser engagiertes Partnerteam ist hier, um Ihnen bei jedem Schritt zu helfen. Egal, ob Sie Fragen zur Integration haben oder Hilfe bei Ihrem Konto benötigen, wir sind für Sie da.

hello@escaperooms.at
+43 676 776 86 44
Was die Partnerschaft umfasst
  • Keine Vorauszahlungen
  • Provision nur für abgeschlossene Buchungen
  • Ihr Eintrag auf Deutsch und Englisch
  • API, Buchungs-Widget oder Promo-Link
  • Partnerportal mit Buchungen, Auszahlungen und Rechnungen
Partnerschaftsprozess
  1. Konto erstellen
  2. Registrieren Sie Ihren Escape Room
  3. Implementieren Sie die API-Endpunkte
  4. Verbinden und testen Sie Ihre API
  5. Beginnen Sie, Buchungen zu erhalten!
Partnerkonto erstellen