Skip to main content

​
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": "voce@empresa.com.br",
    "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.
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNseDFhYmMiLCJyb2xlIjoiVVNFUiJ9...",
  "user": {
    "id": "clx1abc123",
    "email": "voce@empresa.com.br",
    "role": "USER"
  }
}

​
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.