Pular para o conteúdo
Aera+ Docs

Autenticação

A API utiliza autenticação JWT Bearer Token. Após fazer login, inclua o token no header Authorization para todos os endpoints protegidos.

Como Funciona

Seção intitulada “Como Funciona”
  1. Registre-se ou faça login para obter um token de acesso
  2. Inclua o token em todas as requisições subsequentes
  3. Renove o token quando expirar

Header de Autorização

Seção intitulada “Header de Autorização”
Authorization: Bearer <seu-token-de-acesso>

Expiração do Token

Seção intitulada “Expiração do Token”
ModoDuração
Padrão60 minutos
Com “Lembrar-me”43.200 minutos (~30 dias)

Exemplo de Login

Seção intitulada “Exemplo de Login”

Requisição

Seção intitulada “Requisição”
POST /api/v1/auth/login
Content-Type: application/json


{
  "email": "usuario@exemplo.com",
  "password": "senha_segura",
  "remember_me": false
}

Resposta

Seção intitulada “Resposta”
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

Usando o Token

Seção intitulada “Usando o Token”

Após obter o token, inclua-o em todas as requisições:

GET /api/v1/users/me
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Tratando Erros de Autenticação

Seção intitulada “Tratando Erros de Autenticação”

Token Inválido ou Expirado

Seção intitulada “Token Inválido ou Expirado”
{
  "detail": "Could not validate credentials"
}

Código HTTP: 401 Unauthorized

Token Ausente

Seção intitulada “Token Ausente”
{
  "detail": "Not authenticated"
}

Código HTTP: 401 Unauthorized

Logout

Seção intitulada “Logout”

Para invalidar um token:

POST /api/v1/auth/logout
Authorization: Bearer <token>

Resposta

Seção intitulada “Resposta”
{
  "message": "Successfully logged out"
}