Skip to main content
A Super utiliza autenticação via Bearer Token com JWT (JSON Web Token) para garantir a segurança das suas APIs. Este documento explica como funciona o processo de autenticação e como utilizá-lo corretamente.

Visão Geral

  • Tipo de Autenticação: Bearer Token (JWT)
  • Tempo de Expiração: 3600 segundos (1 hora)
  • Formato do Token: JWT (JSON Web Token)

Obtendo as Credenciais

Para gerar um token de acesso, você precisará de duas credenciais essenciais:
  1. Public Key: Identificador público da sua conta
  2. Secret Key: Chave secreta para autenticação
Estas credenciais podem ser encontradas na sua Dashboard da Super, na aba de integração.
Mantenha suas credenciais em segurança e nunca as compartilhe. A Secret Key é especialmente sensível e deve ser tratada como uma senha.

Expiração do Token

Os tokens JWT têm um tempo de expiração de 1 hora (3600 segundos). Após este período, o token se torna inválido e você receberá um erro 401 (Unauthorized) ao tentar acessar as APIs. Exemplo de resposta de erro quando o token expira:

Boas Práticas

  1. Renovação Proativa: Implemente a renovação do token antes da expiração
  2. Tratamento de Erros: Sempre trate o erro 401 adequadamente em sua aplicação
  3. Armazenamento Seguro: Armazene o token em memória e nunca em localStorage
  4. Monitoramento: Implemente logs para monitorar falhas de autenticação

Implementação

Para implementar a autenticação em sua aplicação, consulte nossa API Reference de Autenticação que contém exemplos detalhados de como gerar e utilizar o token.
Nunca exponha sua Secret Key no código frontend ou em repositórios públicos. Utilize variáveis de ambiente ou serviços de gerenciamento de segredos.

Exemplo de Uso

Troubleshooting

Problemas Comuns

  1. Token Expirado
    • Sintoma: Erro 401
    • Solução: Gerar um novo token
  2. Credenciais Inválidas
    • Sintoma: Erro 401
    • Solução: Verificar Public Key e Secret Key
  3. Token Mal Formatado
    • Sintoma: Erro 401
    • Solução: Verificar se o token está sendo enviado corretamente no header
Em caso de dúvidas ou problemas com a autenticação, entre em contato com nosso suporte técnico.