Token de API

Como gerar, usar e atualizar o token da API do Controlle.

Equipe Controlle ·

O token de API permite que outros sistemas leiam e gravem dados na sua empresa no Controlle. É usado por desenvolvedores para criar integrações próprias.

Vídeo

Onde fica

Em Configurações, clique em API.

Tela API com o Token de Integração, os links de documentação e contato e as instruções de uso

Gerar o token

  1. Clique em Gerar Token.
  2. Copie o token e guarde em local seguro.

Depois de gerado, o botão passa a ser Atualizar Token.

Usar o token

  1. Clique em Acessar documentação para ver os endpoints disponíveis.
  2. Envie o token no cabeçalho de todas as requisições: Authorization: Bearer SEU_TOKEN.

Atualizar o token

Atualizar Token gera um novo e invalida o anterior. Todas as integrações que usavam o token antigo param de funcionar até serem atualizadas. Use quando houver suspeita de que o token vazou.

Segurança

  • O token dá acesso aos dados financeiros da empresa. Não envie por e-mail ou mensagem e não publique em código aberto.
  • Cada empresa tem o seu token.

Dúvidas técnicas

O link Entre em contato, na mesma tela, leva ao canal de dúvidas sobre integração.

Não sou desenvolvedor

Para consultar os dados sem programar, veja Conectar o Controlle ao ChatGPT e ao Claude.