Nesta seção, você aprenderá como autenticar-se na API, renovar tokens e acessar recursos protegidos com segurança.🔑 Métodos de Autenticação#
A API oferece dois métodos de autenticação via Bearer Token:Método 1: Token Permanente#
Ideal para: Integrações de produção e sistemas automatizadosApós o cadastro na plataforma:1.
Acesse o Painel do Vendedor
3.
Gere um Token Permanente (recomendado para integrações)
4.
Anote o token em local seguro (não será mostrado novamente)
Você pode obter um token de acesso temporário, com validade de 24 horas, utilizando suas credenciais.Exemplo de resposta#
Junto ao token, é fornecido um refresh token, que permite renovar a sessão automaticamente, sem a necessidade de informar o e-mail e a senha novamente.
⚠️ Limitações importantes:Requer renovação periódica via refresh token
🔄 Renovação de Token (Refresh Token)#
O refresh token permite renovar o token de acesso sem precisar fazer login novamente. Isso é especialmente útil para aplicações que precisam manter a sessão ativa por períodos prolongados.Importante: Para renovar o token, você precisa enviar o Bearer token atual juntamente com o refresh token no corpo da requisição.
Exemplo de resposta#
Importante: Sempre que você renovar o token, receberá um novo par de tokens (token de acesso e refresh token). O refresh token antigo será invalidado.
🚪 Logout#
Para encerrar a sessão e invalidar o token, utilize o endpoint de logout:Para obter informações do usuário autenticado:📍 Rotas de Autenticação#
A seguir estão as rotas disponíveis para autenticação na área do cliente:| Método | Rota | Descrição |
|---|
| POST | /api/v1/auth/login | Autentica o usuário e retorna tokens de acesso |
| POST | /api/v1/auth/refresh | Renova o token de acesso usando o refresh token |
| POST | /api/v1/auth/logout | Invalida o token de acesso atual |
| GET | /api/v1/auth/me | Retorna informações do usuário autenticado |
📊 Fluxos de Autenticação#
Fluxo 1: Autenticação via Email/Senha#
Fluxo 2: Renovação de Token#
Fluxo 3: Acesso a Recursos Protegidos#
Modified at 2025-08-29 14:19:47