Pular para o conteúdo principal

Referência da API

Autenticação

Autenticação

O MenuGaze usa autenticação baseada em JWT. Todos os endpoints autenticados exigem um Bearer token válido no cabeçalho Authorization. Os tokens são obtidos ao fazer login pelos endpoints de autenticação abaixo.

POST /api/auth/signup

Cria uma nova conta.

Autenticação: pública (nenhum token necessário)

Limite de taxa: 10 requisições a cada 15 minutos por IP

Corpo da requisição

{
  "name": "Jane Smith",
  "email": "jane@example.com",
  "password": "securepassword123",
  "restaurantName": "Jane's Bistro"
}

Resposta (201 Created)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

POST /api/auth/login

Faz login com uma conta existente.

Autenticação: pública (nenhum token necessário)

Limite de taxa: 10 requisições a cada 15 minutos por IP

Corpo da requisição

{
  "email": "jane@example.com",
  "password": "securepassword123"
}

Resposta (200 OK)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

Usando o token

Inclua o token no cabeçalho Authorization de todas as requisições autenticadas:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Respostas de erro

  • 400 — Campos ausentes ou inválidos no corpo da requisição.
  • 401 — E-mail ou senha inválidos.
  • 429 — Limite de taxa excedido. Consulte o cabeçalho Retry-After para saber quantos segundos faltam para poder tentar novamente.