Documentación de la API: Inicio de Sesión

Endpoint

POST /api/login

Descripción

Este endpoint permite a un usuario iniciar sesión en el sistema. El usuario debe proporcionar su correo electrónico y contraseña. Si las credenciales son válidas, se genera un token JWT (JSON Web Token) que el usuario puede utilizar para autenticarse en solicitudes futuras. La respuesta incluye el token y, si el usuario está asociado a una empresa, también incluye información relacionada con esa empresa.

Solicitud

Cuerpo de la Solicitud

• email: cadena

  (Requerido) Correo electrónico del usuario que intenta iniciar sesión.

• password: cadena

  (Requerido) Contraseña del usuario.

Ejemplo de Cuerpo de Solicitud:

{
  "email": "[email protected]",
  "password": "ContraseñaSegura123"
}

Encabezados

• Content-Type: application/json (Requerido) Indica que el cuerpo de la solicitud está en formato JSON.

Respuestas

Respuesta de Éxito

• Código de Estado: 200 OK
• Tipo de Contenido: application/json
• Cuerpo de la Respuesta:

  • Si el usuario está asociado a una empresa:

    {
      "success": true,
      "token": "cadena_del_token_jwt",
      "userId": "número",
      "empresaId": "número",
      "rolId": "número"
    }
    

  • Si el usuario no está asociado a una empresa:

    {
      "success": true,
      "token": "cadena_del_token_jwt",
      "userId": "número",
      "empresaId": null,
      "rolId": null
    }
    

Respuestas de Error

• Código de Estado: 400 Bad Request

  • Razón: Usuario no encontrado o contraseña incorrecta.

  • Cuerpo de la Respuesta:

    {
      "success": false,
      "message": "User not found"
    }
    
    

    {
      "success": false,
      "message": "Incorrect password"
    }