Gerar uma API key no MyTourist

Atualizado em 2026-10-01

Objetivo

Precisa de uma API key + base URL para ler os seus dados do MyTourist através do nosso assistente de migração. A chave dá apenas acesso de leitura — não alteramos nada no seu MyTourist.

Passo 1 — Iniciar sessão no MyTourist

Vá a app.mytourist.cloud e inicie sessão como administrador da sua propriedade.

Passo 2 — Ir a Plugins → API

No menu principal, à esquerda: Plugins → API. Se não vir este item de menu, contacte o seu gestor de conta MyTourist (a sua função pode não ter acesso à API).

Passo 3 — Gerar uma nova chave

Clique em + Nova API key.

• Nome: escreva BedFlow migratie — útil para a voltar a encontrar mais tarde.
• Permissions: assinale apenas acesso de leitura para:
  • bookings
  • debtors
  • invoices
  • roomtypes
  • products
  • vouchers
  • calendar
• Acesso de escrita: deixe tudo desligado. Não precisamos dele e é um risco desnecessário.

Clique em Criar.

Passo 4 — Copiar a chave (visível uma só vez!)

O MyTourist mostra a chave uma única vez. Copie-a de imediato ou anote-a num local seguro — se fechar esta janela, nunca mais a vê e terá de gerar uma nova.

A chave tem normalmente este aspeto:

mt_live_KX9p7nRm2qLaY8wE1zU4vH6cI0sD9fG2jK4o

Passo 5 — O base URL

Para a maioria das contas, é:

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

Só o altere se o MyTourist lhe tiver indicado expressamente outro endereço (p. ex. clientes enterprise num subdomínio dedicado).

Passo 6 — Colar no BedFlow

Em bedflow.eu/migrate (passo 2 do assistente), cole os dois valores. Clique em Seguinte — testamos logo se a ligação funciona. Em caso de erro, recebe uma mensagem clara ("Sem ligação — verifique a chave e o URL"); em caso de sucesso, passa para a pré-visualização de teste.

Segurança

• Guarde a sua chave em segurança: não num documento Word no ambiente de trabalho, nem na sua caixa de correio.
• Uma chave para o BedFlow: crie uma chave separada para o BedFlow e não use a mesma de outras integrações. Assim pode revogar só esta, sem afetar as suas outras integrações.
• O que fazemos com ela? Depois de uma importação bem-sucedida, apagamos a chave da migração. Fica guardada na sua propriedade, para que o BedFlow possa ir buscar novas reservas ao MyTourist durante a fase paralela.
• Revogue a chave quando mudar por completo: apague-a no MyTourist assim que deixar de trabalhar no MyTourist. A partir daí, ninguém a pode usar para ler os seus dados do MyTourist.

E se não tiver acesso à API?

Alguns pacotes do MyTourist não oferecem acesso à API. Duas opções:

1. Pergunte ao suporte do MyTourist — para clientes ativos, a API é normalmente acrescentada sem custos.
2. Marque connosco uma conversa gratuita sobre a migração. Ajudamo-lo a pedir o acesso certo, ou transfere as suas reservas com uma exportação CSV: ver Importar os seus dados existentes.