Guia técnico e estratégico para criação e gestão de tokens de API, permitindo integração segura da Quyta com seus sistemas.

Introdução

A interface web da Quyta atende perfeitamente à operação humana.
Mas o verdadeiro poder da automação surge quando sistemas se integram automaticamente.
É aqui que entra a API da Quyta.
A API permite que seu:
ERP
CRM
Sistema financeiro
Plataforma educacional
Software interno
Se comuniquem diretamente com a Quyta.
Para que essa comunicação seja segura, a plataforma utiliza Tokens de API.

Neste artigo, você entenderá:
O que é um token
Como criar
Como armazenar com segurança
Como revogar
Boas práticas de governança

Um Token de API é uma chave digital segura utilizada por sistemas para se autenticar na Quyta.
Enquanto pessoas usam:
E-mail
Senha
Sistemas utilizam:
Token

Ele prova que a requisição é autorizada.

Características Fundamentais de um Token

Apenas administradores podem realizar essa ação.

1. Acesse as configurações
Vá até “Configurações” ou “Administração”.
Clique em “API”, “Integrações” ou “Tokens de API”.

2. Gere um novo token
Clique em “Gerar Novo Token”.
Dê um nome descritivo.
Exemplo adequado:
ERP – Criação de Dívidas
CRM – Atualização de Status
BI – Consulta de Acordos
Evite nomes genéricos como:
Token1
NovoToken
Clique em “Gerar”.

3. Copie imediatamente
O token será exibido na tela.
Esse é o único momento em que ele estará totalmente visível.
Copie e armazene imediatamente em local seguro.
Nunca:
Envie por WhatsApp
Salve em bloco de notas simples
Compartilhe em e-mail não criptografado
Use:
Cofre de segredos
Gerenciador de senhas corporativo
Vault seguro do seu servidor

Revogando um Token

Se um token for:
Comprometido
Vazado
Associado a sistema desativado
Você deve revogá-lo imediatamente.

Como revogar
Acesse a lista de tokens.
Localize pelo nome descritivo.
Clique em “Revogar” ou “Desativar”.
Confirme.
O acesso será bloqueado instantaneamente.
Qualquer sistema que tentar utilizá-lo receberá erro de autenticação.

Cenário: Sua empresa quer automatizar a criação de dívidas.
Sempre que uma fatura vencer no ERP e não for paga, ela deve ser enviada automaticamente para a Quyta.

Como implementar
O administrador gera um token chamado:
“ERP – Envio Automático de Dívidas”
O token é entregue de forma segura ao time de desenvolvimento.
O ERP passa a executar rotina automática:
Identifica faturas vencidas
Envia requisição para API da Quyta
Cria a dívida automaticamente

Resultado:
Eliminação de planilhas manuais
Redução de erro humano
Operação 100% automatizada
Escalabilidade
Se o ERP for substituído no futuro:
Basta revogar o token
Gerar novo token para o novo sistema
Sem impacto nos demais sistemas integrados.

Adote as seguintes práticas:

Riscos de Má Gestão

Má gestão de tokens pode causar:
Vazamento de dados
Criação indevida de dívidas
Alteração não autorizada de acordos
Problemas de compliance
Tokens são chaves de acesso direto ao seu ambiente financeiro.
Trate-os como credenciais críticas.

Posso recuperar um token perdido?
Não. É necessário revogar e gerar um novo.

Quantos tokens posso criar?
Depende da configuração da sua conta, mas é recomendado separar por integração.

Se eu excluir um usuário administrador, o token para de funcionar?
Não. O token é independente do usuário.

Tokens de API são o fundamento da integração segura.
Eles permitem:
Automação
Escalabilidade
Conexão entre sistemas
Mas exigem governança rigorosa.
Uma gestão madura de tokens é sinal de maturidade tecnológica da operação.

Ainda com dúvidas?

Se sua equipe técnica precisar de orientação sobre autenticação ou endpoints:
E-mail: suporte@quyta.com.br