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

string

required

Email cadastrado na conta.

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

string

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

object

Dados básicos do usuário autenticado.

Show campos

string

ID único do usuário.

string

Email do usuário.

string

Papel do usuário: USER ou ADMIN.

200 — Sucesso
200 — 2FA requerido
401 — Credenciais inválidas
403 — Email não verificado

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNseDFhYmMiLCJyb2xlIjoiVVNFUiJ9...",
  "user": {
    "id": "clx1abc123",
    "email": "voce@empresa.com.br",
    "role": "USER"
  }
}

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..."
}

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

{
  "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.

Comece Aqui

Autenticação

Webhooks

Request

Body

Exemplo

Responses

Usando o token

​POST /v1/auth/login

​Request

​Body

​Exemplo

​Responses

​Usando o token

`POST /v1/auth/login`

Request

Body

Exemplo

Responses

Usando o token