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
| Estado | Código | Descripción |
|---|---|---|
| ✅ 200 | 200 OK | La solicitud fue exitosa. |
| ⚠️ 422 | 422 Unprocessable Entity | Error en los datos enviados. |
| ❌ 500 | 500 Internal Server Error | Error 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!"
}