Skip to main content
Este guia explica como configurar e gerenciar tokens de API através da interface do Switch Kanban.

​
Acessando o Gerenciamento de API

  1. Faça login na sua conta do Switch Kanban
  2. Navegue para Configurações clicando no menu lateral
  3. Selecione a seção “API” nas configurações
Somente o administrador da empresa pode gerenciar tokens de API

​
Criando um Novo Token de API

​
Passo a Passo

  1. Na página de API, clique no botão “Adicionar Chave”
  2. Digite um nome descritivo para o seu token (ex: “Integração CRM”, “Automação Deploy”)
  3. Clique em “Criar” para gerar o token

​
⚠️ Importante - Copie o Token Imediatamente

  • Após a criação, o token completo será exibido apenas uma vez
  • Copie e salve o token em um local seguro
  • O sistema mostrará apenas os últimos 4 caracteres do token após essa tela

​
Gerenciando Tokens Existentes

​
Visualizando Tokens

Na página de API, você verá uma lista com todos os seus tokens contendo:
  • Nome do Token: Nome descritivo que você definiu
  • Token: Últimos 4 caracteres (ex: •••••••••••abcd)
  • Criado em: Data de criação do token
  • Último uso: Data da última utilização (se aplicável)

​
Utilizando o Token de API

​
Formato de Autenticação

Para usar o token em suas requisições à API, inclua o cabeçalho de autorização: 
Authorization: Bearer SEU_TOKEN_AQUI

​
Exemplo de Requisição

curl -H "Authorization: Bearer seu_token_completo_aqui" \
     -H "Content-Type: application/json" \
     https://switchkanban.com.br/api/v1/projects

​
Endpoints Disponíveis

A API do Switch Kanban oferece os seguintes endpoints:
  • /api/v1/projects - Gerenciamento de projetos
  • /api/v1/tasks - Gerenciamento de tarefas
  • /api/v1/project_modules - Gerenciamento de módulos de projeto

​
Segurança e Boas Práticas

​
Segurança do Token

  • Mantenha seus tokens seguros: Nunca compartilhe ou exponha tokens em código público
  • Use nomes descritivos: Facilita a identificação e gerenciamento
  • Revogue tokens não utilizados: Remove tokens antigos ou desnecessários
  • Monitore o uso: Verifique regularmente a data de “último uso”

​
Isolamento por Empresa

  • Cada token é restrito à sua empresa
  • Você só pode acessar dados da sua organização
  • Tokens não podem ser compartilhados entre empresas diferentes

​
Permissões

  • Para gerenciar tokens de API, você precisa ter permissões de administração na empresa
  • Apenas usuários com papel de owner ou super_admin podem criar, editar ou excluir tokens

​
Contato

Para suporte adicional ou documentação avançada da API, entre em contato com nossa equipe de desenvolvimento.