Definições
Chaves API
Gerar e revogar chaves de API da organização.
As chaves API autenticam o Canal API — acesso programático aos dados da organização (agentes, chamadas, análises, conhecimento, webhooks) em https://api.diska.ai/v1, restringível por âmbitos.
Criar chave
- Aceda a Definições > Chaves API.
- Clique em Nova chave.
- Dê um nome e, opcionalmente, descrição.
- Escolha os âmbitos (sem selecção = acesso total) e, se quiser, uma data de expiração.
- Guarde a chave completa: só é mostrada uma vez.
Usar a chave
curl https://api.diska.ai/v1/me \
-H "Authorization: Bearer dsk_…"
A lista completa de endpoints está em Canal API. A página de chaves mostra o último uso de cada chave, para identificar chaves esquecidas.
Revogar
Pode revogar uma chave a qualquer momento. Endpoints que usem essa chave falham imediatamente.
Segurança
- guarde chaves em variáveis de ambiente;
- nunca exponha chaves no frontend;
- roteie chaves periodicamente.