Saltar al contenido principal

Referencia de la API

Autenticación

Autenticación

MenuGaze usa autenticación basada en JWT. Todos los endpoints autenticados requieren un token Bearer válido en el encabezado Authorization. Los tokens se obtienen al iniciar sesión mediante los endpoints de autenticación que se describen a continuación.

POST /api/auth/signup

Crea una cuenta nueva.

Autenticación: Pública (no se requiere token)

Límite de solicitudes: 10 solicitudes cada 15 minutos por IP

Cuerpo de la solicitud

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

Respuesta (201 Created)

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

POST /api/auth/login

Inicia sesión con una cuenta existente.

Autenticación: Pública (no se requiere token)

Límite de solicitudes: 10 solicitudes cada 15 minutos por IP

Cuerpo de la solicitud

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

Respuesta (200 OK)

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

Uso del token

Incluya el token en el encabezado Authorization de todas las solicitudes autenticadas:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Respuestas de error

  • 400 — Faltan campos o hay campos no válidos en el cuerpo de la solicitud.
  • 401 — Correo electrónico o contraseña no válidos.
  • 429 — Se superó el límite de solicitudes. Consulte el encabezado Retry-After para saber cuántos segundos faltan para poder reintentar.