Pular para o conteúdo
TicketingHub Help

Como criar e usar um token de API

Os tokens de API permitem que outro sistema se conecte à sua conta do TicketingHub. É necessário ter acesso de administrador para gerenciá-los.

Para que posso usar um token de API?

  • Enviar dados do TicketingHub para um software de relatórios ou um data warehouse.
  • Permitir que uma plataforma de parceiro personalizada consulte produtos e preços.
  • Criar uma experiência de reserva no servidor que verifique a disponibilidade em tempo real.

Um token de API não cria uma conexão integrada com o Google Sheets. Consulte Como exportar dados do TicketingHub e conectar outras ferramentas para escolher entre exportações CSV, Zapier, webhooks e acesso à API.

Ativar o acesso à API

  1. Acesse Configurações → Recursos.
  2. Ative Acesso à API.

Esta é uma configuração de autoatendimento. Depois de ativá-la, a opção Tokens de API aparecerá em Configurações.

Criar um token

  1. Acesse Configurações → Tokens de API.
  2. Selecione Gerar token de API.
  3. Insira um nome que identifique o sistema que usará o token.
  4. Escolha Supplier API (V2) para o gerenciamento de fornecedores, Widget API para disponibilidade e reservas ou OCTO API para conectar sistemas que utilizam o padrão OCTO.
  5. Se você escolheu Supplier API (V2) ou OCTO API, poderá selecionar Somente leitura quando a integração precisar apenas consultar dados. Essa opção não se aplica a tokens da Widget API.
  6. Adicione uma data de expiração, se necessário, e gere o token.
  7. Copie o token imediatamente e armazene-o com segurança. O token completo será exibido apenas uma vez.

Usar o token

Envie o token no cabeçalho Authorization de cada solicitação à API:

Authorization: Bearer YOUR_TOKEN

Use tokens de API somente em sistemas seguros no servidor. Não coloque um token no código do site, em e-mails, mensagens de chat ou documentos compartilhados.

Revogar um token

Acesse Configurações → Tokens de API e selecione Revogar ao lado do token. A revogação entra em vigor imediatamente, portanto o sistema conectado deixará de funcionar até usar um token substituto.

Crie um token separado para cada integração, conceda apenas o acesso necessário e revogue os tokens que não estiverem mais em uso. Para atualizações baseadas em eventos, você pode preferir webhooks ou a integração com o Zapier.