Chaves de API

Fica em Configurações → API Keys, com a descrição "Gerencie suas chaves de API para integrações".

Uma chave de API é uma credencial para outro sistema conversar com o TKDASH sem usuário e senha — para levar o dado do TKDASH a um BI próprio, por exemplo.

Criar uma chave

Em Nova, você dá um nome à chave. Use um nome que diga quem vai usá-la ("Power BI financeiro", "integração e-commerce"), não um nome genérico: o dia em que precisar revogar uma delas, é esse nome que vai te dizer o que quebra.

A chave aparece uma vez só

Depois de criar, o TKDASH mostra a chave numa tela de resultado. Copie e guarde naquele momento. Ela não é exibida de novo.

Isso não é limitação, é como credencial deve funcionar: o sistema guarda apenas o suficiente para validar, não a chave em si. Se você perdeu, o caminho é revogar e criar outra.

Editar e revogar

Editar ajusta o cadastro da chave — o nome, por exemplo.

Revogar invalida a chave imediatamente. Qualquer integração que a esteja usando para de funcionar na hora, então confirme quem depende dela antes.

Cuidados

• Trate a chave como senha: ela não deve ir para e-mail, planilha compartilhada nem repositório de código.
• Uma chave por integração. Chave compartilhada entre sistemas não pode ser revogada sem derrubar todos de uma vez.
• Revogue ao desligar a integração. Chave ativa de sistema desativado é porta aberta sem ninguém olhando.

Relacionado

Como usar a chave está na Referência da API.