Die Regiondotour-API für Ihre internen Entwicklungen nutzen

Die Regiondotour-API gibt Ihren Entwicklerinnen und Entwicklern kontrollierten Zugriff auf Buchungsdaten, Verfügbarkeiten, Zeitfenster-Preise und Kundenprofile Ihres Anbieter-Kontos. Dieser Artikel erläutert die Grundprinzipien der Anbindung, typische Anwendungsfälle für Incoming-Agenturen und wie Webhooks eine saubere ereignisgetriebene Architektur ermöglichen.

Authentifizierung und API-Schlüssel

Die Regiondotour-API verwendet eine Authentifizierung per API-Schlüssel, den Sie im Anbieter-Bereich unter Einstellungen → Integrationen → API-Zugang generieren. Jeder Schlüssel ist einem Anbieter-Konto zugeordnet und lässt sich auf bestimmte Berechtigungen einschränken: Buchungen lesen, Buchungen schreiben, Verfügbarkeiten lesen, Preise ändern, Kundenprofile lesen oder Zugriff auf Berichte.

Wir empfehlen, pro Integration einen eigenen Schlüssel anzulegen (einen für Ihr CRM, einen für Ihre BI, einen für Ihre Ticketing-Lösung) statt einen einzigen Schlüssel überall zu verwenden. So lassen sich kompromittierte Schlüssel gezielt widerrufen und die Zugriffs-Logs bleiben lesbar. Jeder Aufruf muss den Schlüssel im Header X-Api-Key mitschicken und ausschließlich über HTTPS erfolgen.

Buchungen Ihrer Touren auslesen

Der Endpunkt /reservations liefert Buchungen für einen definierten Abreisezeitraum, gefiltert nach Aktivität, Reiseleiter oder Herkunftskanal. Die Antwort enthält die Buchungs-ID, den Namen des Hauptbuchers, die Teilnehmerzahl je Tarifkategorie (Erwachsene, Kinder, Senioren), das Zeitfenster, den Treffpunkt, den Zahlungsstatus und den Kanal, über den die Buchung zustande kam (Direktseite, GetYourGuide, Viator, lokaler Wiederverkäufer).

Der häufigste Anwendungsfall ist die tägliche Synchronisation dieser Buchungen in ein internes CRM, um eine einheitliche Kundenansicht aufzubauen: Teilnahmehistorie, Sprachpräferenzen, Ernährungsvorlieben, Treuepunkte. Ein Aufruf alle sechs Stunden reicht für die meisten Anbieter aus.

Verfügbarkeiten und Zeitfenster-Preise steuern

Der Endpunkt /availability verwaltet Zeitfenster: verbleibende Plätze, Mindestteilnehmerzahl für eine Durchführung, manuelle Sperren für Wartung. Über /pricing lassen sich zudem dynamische Preisraster (Saisonpreise, Last-Minute-Aktionen, Gruppentarife) einspielen.

Ein typisches Einsatzszenario: Ihr Revenue Manager spielt jeden Montagmorgen die Preistabelle für die Folgewoche ein und berücksichtigt dabei Wetterprognose und aktuelle Auslastung. Die API verteilt die Änderungen anschließend in weniger als zwei Minuten auf Ihre Direktseite und alle angeschlossenen Vertriebskanäle (GetYourGuide, Viator, Musement, Regiondo).

Webhooks: ereignisgetriebene Architektur

Statt die API per Polling abzufragen, können Sie Webhooks für die wichtigsten Ereignisse registrieren: reservation.created, reservation.cancelled, reservation.modified, tour.checked_in, refund.issued. Regiondotour sendet dann per POST einen HTTP-Aufruf an Ihren Endpunkt, sobald das Ereignis eintritt.

Webhooks eignen sich, um sofort eine individuelle Bestätigungs-E-Mail zu verschicken, ein Live-Dashboard zu aktualisieren oder externe Partner (freiberuflicher Reiseleiter, Transportunternehmen, Partnerrestaurant) darüber zu informieren, dass eine weitere Person eingeplant werden muss. Jede Nutzlast ist per HMAC-SHA256 signiert, um die Herkunft zu bestätigen.

Ratenlimits und bewährte Vorgehensweisen

Um die Plattform stabil zu halten, gilt bei Regiondotour ein Limit von 600 Anfragen pro Minute je API-Schlüssel. Ein Überschreiten liefert HTTP 429 mit einem Retry-After-Header, der die einzuhaltende Wartezeit angibt. Wir empfehlen einen exponentiellen Backoff: 1 Sekunde beim ersten 429, 2 Sekunden beim zweiten, 4 Sekunden beim dritten.

Bündeln Sie Aufrufe, wo immer möglich: Eine Anfrage /reservations?from=2026-08-01&to=2026-08-31 ist einer Serie von dreißig Einzelaufrufen vorzuziehen. Nutzen Sie Webhooks für Einzelereignisse und Polling nur für geplante Synchronisationen.

Testumgebung und Dokumentation

Jedes Anbieter-Konto verfügt über eine Sandbox, die strukturell identisch zur Produktion ist, aber vollständig isoliert läuft. Nutzen Sie sie, um Ihre Integrationen zu testen, ohne echte Buchungen anzulegen. Die vollständige Dokumentation, die OpenAPI-Schemas und eine gebrauchsfertige Postman-Collection finden Sie auf der Seite API-Dokumentation.