Gerar API-key no MyTourist

Atualizado em 2026-04-26

Objetivo

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

Passo 1 — Inicie sessão no MyTourist

Aceda a app.mytourist.cloud e inicie sessão como administrador da sua property.

Passo 2 — Vá a Plugins → API

No menu principal à esquerda: Plugins → API. Se não vir o item de menu, contacte o seu account-manager MyTourist (o seu papel pode não ter acesso à API).

Passo 3 — Gere uma nova key

Clique em + Nova API-key.

• Nome: digite BedFlow migração — útil para a encontrar mais tarde.
• Permissões: marque apenas acesso de leitura para:
  • bookings
  • debtors
  • invoices
  • roomtypes
  • products
  • vouchers
  • calendar
• Acesso de escrita: deixe tudo desligado. Não precisamos e é um risco desnecessário.

Clique em Criar.

Passo 4 — Copie a key (visível 1×!)

O MyTourist mostra a key uma única vez. Copie-a logo ou guarde-a num local seguro — se fechar esta janela não volta a vê-la e tem de gerar uma nova.

A key tem habitualmente este aspeto:

mt_live_KX9p7nRm2qLaY8wE1zU4vH6cI0sD9fG2jK4o

Passo 5 — A base URL

Para a maioria das contas é:

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

Altere isto apenas se o MyTourist lhe tiver indicado explicitamente outro endereço (por ex. clientes enterprise num subdomínio dedicado).

Passo 6 — Cole no BedFlow

Em bedflow.eu/migrate (passo 2 do assistente) cola ambos os valores. Clique em Seguinte — testamos imediatamente se a ligação funciona. Em caso de erro recebe uma mensagem clara ("Sem ligação — verifique a sua key e URL"); em caso de sucesso passa à pré-visualização dry-run.

Segurança

• Guarde a sua key em segurança: não num documento Word no seu desktop, não na sua pasta de e-mail. Nós guardamo-la encriptada até depois da migração e apagamo-la depois automaticamente.
• Uma key por migração: crie uma key separada para o BedFlow, não use a mesma de outras integrações. Assim pode revogar esta sem afetar os seus outros fluxos.
• Revogue a key após o onboarding: depois de uma migração bem-sucedida pode apagar a key no MyTourist. Nós já não a temos a partir desse momento.

E se eu não tiver acesso à API?

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

1. Pergunte ao support do MyTourist — para um cliente ativo, a API costuma poder ser acrescentada gratuitamente.
2. Reserve uma sessão de migração hands-on connosco (€90/h). Ajudamo-lo a pedir o upgrade do pacote correto ou fazemos a migração por outra via.