Skip to main content

Inicio de sesión

El servicio de login permite autenticar a los usuarios y obtener un access_token para acceder a los recursos protegidos y un refresh_token para actualizar la validez del token.

Método: POST
URL: /api/auth/login
Ejemplo de Request:

{
"email": "usuario@example.com",
"password": "contraseña"
}

Códigos de Estado

EstadoCódigoDescripción
✅ 200200 OKLa solicitud fue exitosa.
⚠️ 422422 Unprocessable EntityError en los datos enviados.
❌ 500500 Internal Server ErrorError interno del servidor.

Respuestas detalladas

200 OK - Solicitud exitosa

  • Descripción: La solicitud se procesó correctamente.
  • Respuesta:
{
"success": true,
"message": "User has been logged successfully.",
"token": { "access_token": "..." }
}

422 Unprocessable Entity - Error en los datos enviados

  • Descripción: Los datos enviados no cumplen con las reglas de validación.
  • Respuesta:
{
"success": false,
"message": "Error al validar los datos.",
"errors": [{ "field": "email", "message": "El correo es inválido." }]
}

500 Internal Server Error - Error en el servidor

  • Descripción: Ocurrió un problema inesperado en el servidor.
  • Respuesta:
{
"success": false,
"message": "¡Ocurrio un problema. Contacte a soporte!"
}