Guida / Migrazione

Generare una API key in MyTourist

Aggiornato il 2026-10-01

Obiettivo

Ti servono una API key + l'URL di base per leggere i tuoi dati di MyTourist tramite la nostra procedura guidata di migrazione. La key concede solo accesso in lettura: non modifichiamo nulla nel tuo MyTourist.

Passaggio 1 — Accedi a MyTourist

Vai su app.mytourist.cloud e accedi come amministratore della tua struttura.

Passaggio 2 — Vai su Plugins → API

Nel menu principale a sinistra: Plugins → API. Se non vedi la voce di menu, contatta il tuo account manager di MyTourist (il tuo ruolo potrebbe non avere accesso all'API).

Passaggio 3 — Genera una nuova key

Clicca su + New API key.

  • Nome: digita BedFlow migration — comodo per ritrovarla in seguito.
  • Permessi: spunta l'accesso in sola lettura per:
    • bookings
    • debtors
    • invoices
    • roomtypes
    • products
    • vouchers
    • calendar
  • Accesso in scrittura: lascia tutto disattivato. Non ci serve ed è un rischio inutile.

Clicca su Create.

Passaggio 4 — Copia la key (visibile una sola volta!)

MyTourist mostra la key una sola volta. Copiala subito o annotala in un posto sicuro: se chiudi questa finestra, non la vedrai mai più e dovrai generarne una nuova.

La key di solito si presenta così:

mt_live_KX9p7nRm2qLaY8wE1zU4vH6cI0sD9fG2jK4o

Passaggio 5 — L'URL di base

Per la maggior parte degli account è:

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

Modificalo solo se MyTourist ti ha indicato esplicitamente un altro indirizzo (ad es. clienti enterprise su un sottodominio dedicato).

Passaggio 6 — Incolla in BedFlow

Su bedflow.eu/migrate (passaggio 2 della procedura guidata), incolla entrambi i valori. Clicca su Avanti: verifichiamo subito se il collegamento funziona. In caso di errore ricevi un messaggio chiaro ("Nessun collegamento — controlla la tua key e l'URL"); se riesce, prosegui con l'anteprima di prova.

Sicurezza

  • Custodisci bene la tua key: non in un documento Word sul desktop, non nella tua casella di posta.
  • Una key per BedFlow: crea una key separata per BedFlow e non usare la stessa delle altre integrazioni. Così puoi revocare questa sola key senza toccare le altre integrazioni.
  • Cosa ne facciamo? Dopo un'importazione riuscita, eliminiamo la key dalla migrazione. Resta salvata con la tua struttura, così BedFlow può recuperare nuove prenotazioni da MyTourist durante la fase parallela.
  • Revoca la key quando passi del tutto a BedFlow: eliminala in MyTourist non appena non lavori più in MyTourist. Da quel momento nessuno potrà più usarla per leggere i tuoi dati di MyTourist.

E se non ho accesso all'API?

Alcuni pacchetti MyTourist non offrono l'accesso all'API. Due opzioni:

  1. Chiedi al supporto di MyTourist — per i clienti attivi l'accesso all'API di solito si può aggiungere senza costi.
  2. Prenota con noi una chiamata di migrazione gratuita. Ti aiutiamo a richiedere l'accesso giusto, oppure puoi trasferire le tue prenotazioni con un'esportazione CSV: vedi Importare i tuoi dati esistenti.
← Torna alla categoria