Login

POST /api/auth/login

Autentica um usuário com nome de usuário ou e-mail e senha. Retorna um token de acesso no corpo da resposta e define um token de renovação como cookie HTTP-only.

Auth: Pública (não requer autenticação)

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`identifier`	string	Sim	Nome de usuário ou endereço de e-mail
`password`	string	Sim	Senha do usuário (mínimo de 8 caracteres)

Exemplo

curl -X POST https://api.reten.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "admin@example.com",
    "password": "SecurePass123!"
  }'

const response = await fetch("https://api.reten.ai/api/auth/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    identifier: "admin@example.com",
    password: "SecurePass123!",
  }),
});
const data = await response.json();
const accessToken = data.accessToken;

import requests

response = requests.post(
    "https://api.reten.ai/api/auth/login",
    json={
        "identifier": "admin@example.com",
        "password": "SecurePass123!",
    },
)
data = response.json()
access_token = data["accessToken"]

Resposta `201 Created`

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "username": "jdoe",
    "email": "jdoe@example.com",
    "firstName": "Jane",
    "lastName": "Doe",
    "roles": ["viewer"],
    "permissions": [
      "project:view",
      "user:view",
      "activity:view",
      "commerce-lifecycle-snapshot:view"
    ],
    "tenantIds": ["660e8400-e29b-41d4-a716-446655440000"]
  }
}

Campo	Tipo	Descrição
`accessToken`	string	Token de acesso para o header `Authorization: Bearer`
`user.roles`	string[]	Valores das funções do usuário (veja Funções e Permissões)
`user.permissions`	string[]	Permissões concedidas por todas as funções do usuário; a ordem não é garantida
`user.tenantIds`	string[]	Tenants aos quais o usuário pertence — cada um é um `x-tenant-id` válido

O token de acesso carrega roles, permissions e tenantIds como estavam no momento em que foi emitido: uma mudança de funções entra em vigor no próximo login ou na próxima renovação.

O token de renovação é definido como um cookie HTTP-only (refreshToken) com expiração de 7 dias.

Respostas de Erro

Status	Descrição
`400`	Erro de validação — `identifier` está vazio ou `password` tem menos de 8 caracteres
`401`	Identificador ou senha incorretos — `Invalid credentials`
`401`	O usuário está desativado — `User account is deactivated`