Documentação da API | Autenticação

🔐 Proteção via API Key

Todas as requisições desta API exigem uma API Key ativa. Você deve enviá-la através do cabeçalho x-api-key.

Headers Obrigatórios (Todas as rotas)

x-api-key: api_key_suachaveaqui

Gerenciar Chaves de API →

Registrar Usuário

POST /api/auth/registro

Cria uma nova conta de usuário no sistema (o token é retornado apenas no login).

Body (JSON)

{
  "name": "João Silva",
  "email": "joao@exemplo.com",
  "password": "senha_super_segura"
}

Resposta de Sucesso (201 Created)

{
  "mensagem": "Usuário registrado com sucesso!",
  "usuario": {
    "id": "278c2e9b-...",
    "nome": "João Silva",
    "email": "joao@exemplo.com"
  }
}

Autenticar Usuário

POST /api/auth/entrar

Autentica um usuário existente usando e-mail e senha.

Body (JSON)

{
  "email": "joao@exemplo.com",
  "password": "senha_super_segura"
}

Resposta de Sucesso (200 OK)

{
  "mensagem": "Login realizado com sucesso!",
  "usuario": {
    "id": "278c2e9b-...",
    "nome": "João Silva",
    "email": "joao@exemplo.com"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI..."
}

Buscar Perfil Requer Autenticação

GET /api/auth/eu

Retorna os detalhes do usuário atualmente logado.

Headers

Authorization: Bearer

Resposta de Sucesso (200 OK)

{
  "usuario": {
    "id": "278c2e9b-...",
    "nome": "João Silva",
    "email": "joao@exemplo.com",
    "criadoEm": "2026-08-02T18:00:00.000Z"
  }
}