Handbuch / Migration

API-Key in MyTourist generieren

Aktualisiert am 2026-04-26

Ziel

Sie benötigen einen API-Key + Base-URL, um Ihre MyTourist-Daten über unseren Migrations-Wizard auszulesen. Der Key gewährt nur Lese-Zugriff — wir ändern nichts an Ihrem MyTourist.

Schritt 1 — Anmelden bei MyTourist

Gehen Sie zu app.mytourist.cloud und melden Sie sich als Administrator Ihrer Property an.

Schritt 2 — Navigieren zu Plugins → API

Im Hauptmenü links: Plugins → API. Wenn Sie den Menüpunkt nicht sehen, kontaktieren Sie Ihren MyTourist-Account-Manager (Ihre Rolle hat möglicherweise keinen API-Zugriff).

Schritt 3 — Einen neuen Key generieren

Klicken Sie auf + Neuer API-Key.

  • Name: Tippen Sie BedFlow Migration — praktisch, um ihn später wiederzufinden.
  • Permissions: Aktivieren Sie nur Lese-Zugriff für:
    • bookings
    • debtors
    • invoices
    • roomtypes
    • products
    • vouchers
    • calendar
  • Schreib-Zugriff: Lassen Sie alles deaktiviert. Wir benötigen ihn nicht und es wäre ein unnötiges Risiko.

Klicken Sie auf Anlegen.

Schritt 4 — Den Key kopieren (1× sichtbar!)

MyTourist zeigt den Key einmal. Kopieren Sie ihn sofort oder schreiben Sie ihn an einem sicheren Ort auf — wenn Sie dieses Fenster schließen, sehen Sie ihn nie wieder und müssen einen neuen generieren.

Der Key sieht typischerweise so aus:

mt_live_KX9p7nRm2qLaY8wE1zU4vH6cI0sD9fG2jK4o

Schritt 5 — Die Base-URL

Für die meisten Konten ist das:

https://app.mytourist.cloud/api/v1

Passen Sie das nur an, wenn MyTourist Ihnen ausdrücklich eine andere Adresse mitgeteilt hat (z. B. Enterprise-Kunden auf einer dedizierten Subdomain).

Schritt 6 — In BedFlow einfügen

Auf bedflow.eu/migrate (Schritt 2 des Wizards) fügen Sie beide Werte ein. Klicken Sie auf Weiter — wir prüfen sofort, ob die Verbindung funktioniert. Bei einem Fehler erhalten Sie eine klare Meldung ("Keine Verbindung — prüfen Sie Ihren Key und Ihre URL"); bei Erfolg gehen Sie weiter zur Dry-Run-Vorschau.

Sicherheit

  • Bewahren Sie Ihren Key sicher auf: nicht in einem Word-Dokument auf dem Desktop, nicht in Ihrem E-Mail-Ordner. Wir speichern ihn verschlüsselt bis nach der Migration und löschen ihn dann automatisch.
  • Ein Key pro Migration: Erstellen Sie einen separaten Key für BedFlow, verwenden Sie nicht denselben wie für andere Integrationen. So können Sie diesen einen widerrufen, ohne Ihre anderen Flows zu beeinträchtigen.
  • Key nach Onboarding widerrufen: Nach erfolgreicher Migration können Sie den Key in MyTourist löschen. Wir haben ihn dann ohnehin nicht mehr.

Was, wenn ich keinen API-Zugriff habe?

Manche MyTourist-Pakete bieten keinen API-Zugriff. Zwei Optionen:

  1. Fragen Sie beim MyTourist-Support — bei aktivem Kunden ist die API meist kostenlos hinzubuchbar.
  2. Buchen Sie eine Hands-on-Migrations-Sitzung bei uns (€90/Std.). Wir helfen Ihnen, das richtige Paket-Upgrade zu beantragen, oder führen die Migration über einen anderen Weg durch.
← Zurück zur Kategorie