Login

Autentique-se com email e senha para obter um token JWT.

POST /v1/auth/login

Realiza o login do usuário. Retorna um token JWT para uso nas requisições autenticadas.

Se a autenticação de dois fatores (2FA) estiver ativa na conta, o endpoint retorna um tempToken temporário ao invés do JWT definitivo. O token definitivo só é emitido após a verificação do código TOTP.

---

Request

POST https://api.liquera.com.br/v1/auth/login
Content-Type: application/json

Body

email · string · required

Email cadastrado na conta.

password · string · required

Senha da conta. Mínimo de 6 caracteres.

Exemplo

curl -X POST https://api.liquera.com.br/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[e-mail]",
    "password": "minha_senha_segura"
  }'

---

Responses

token · string

Token JWT para uso no header Authorization: Bearer. Expira em 7 dias.

user · object

Dados básicos do usuário autenticado.

Show campos

user.id · string

ID único do usuário.

user.email · string

Email do usuário.

user.role · string

Papel do usuário: USER ou ADMIN.

200 — Sucesso

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNseDFhYmMiLCJyb2xlIjoiVVNFUiJ9...",
  "user": {
    "id": "clx1abc123",
    "email": "[e-mail]",
    "role": "USER"
  }
}

200 — 2FA requerido

Quando o 2FA está ativo, o login retorna um tempToken de curta duração (5 minutos). Use-o na rota de verificação do código TOTP para obter o JWT definitivo.

{
  "requiresTwoFactor": true,
  "tempToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

401 — Credenciais inválidas

{
  "message": "email ou senha invalidos"
}

403 — Email não verificado

{
  "message": "Email não verificado. Verifique sua caixa de entrada.",
  "code": "EMAIL_NOT_VERIFIED"
}

---

Usando o token

Após o login, inclua o JWT em todas as requisições autenticadas:

curl https://api.liquera.com.br/v1/charges \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Para integrações em produção, prefira criar uma API Key e usar ela no lugar do JWT. O JWT expira em 7 dias; a API Key permanece ativa até ser deletada.