Chaves de API

Chaves de API dão a integrações externas acesso programático aos dados do seu workspace sem usar o login de um membro. Somente para administradores. Cada chave carrega um rótulo legível pelo administrador (para que ela serve) e registra a data de criação + o timestamp do último uso, para você identificar chaves obsoletas.

Criando uma chave

1. Clique em Criar chave no topo da página.
2. Informe um rótulo descritivo — para que ela serve? Exemplos: "Integração com Zapier", "Ferramenta interna de relatórios", "App mobile".

3. Clique em Criar. A chave é exibida uma única vez — copie-a imediatamente. Você não a verá de novo depois de fechar o banner.
4. Cole a chave na sua integração. O Zellbox a aceita como Authorization: Bearer <key> em todo endpoint que aceita autenticação JWT.

Trate as chaves como senhas. Quem tiver a chave tem o mesmo acesso aos dados que o administrador do workspace. Faça a rotação imediatamente se uma chave vazar.

Rotacionando uma chave

Não há rotação no mesmo lugar. Para rotacionar:

1. Crie uma nova chave com o mesmo propósito.
2. Atualize sua integração com a chave nova.
3. Depois de confirmar que a integração funciona, exclua a chave antiga da lista.

Excluindo uma chave

1. Encontre a chave na lista.
2. Clique em Excluir na linha dela.
3. Confirme no diálogo. A chave é revogada instantaneamente — quaisquer requisições em andamento que a estiverem usando vão começar a falhar com 401 na próxima chamada.