Iniciar sesión

POST 
/auth/login

Valida email y contraseña y emite un token Bearer (token de acceso personal) con la vigencia configurada en el servidor (90 días por defecto). El token emitido aparece también en GET /tokens con el email del usuario como nombre. Condiciones para emitirlo: usuario activo, email verificado y empresa asociada activa. Registra el acceso (usuario + IP).

Request

Responses

200

Login exitoso

400

El email del usuario no ha sido verificado.

404

Credenciales inválidas, usuario inactivo o empresa inactiva. message indica el caso: Credenciales inválidas. | El usuario se encuentra inactivo. Comuníquese con el administrador. | La empresa se encuentra inactiva. Comuníquese con el administrador.

422

Validación fallida: email ausente, vacío, no enviado como texto o con formato inválido; password ausente, vacío o no enviado como texto (p. ej. un número JSON: debe enviarse como string aunque sea numérico); o remember_me no booleano.

429

Límite general de 60 peticiones por minuto excedido (sin sesión, se cuenta por IP). La cabecera Retry-After indica los segundos de espera.

500

(1) Error al emitir el token o al registrar el acceso: success = false y message con el texto del error (Error interno del servidor. ...; si el error es de base de datos, un texto seguro sin el SQL). (2) El usuario no tiene empresa asociada, o la empresa asociada no existe: el endpoint no controla este caso y responde el 500 genérico del servidor, sin success y sin este formato: {"message":"Server Error"} si se envía Accept: application/json (una página HTML si no). Nota: por eso este endpoint nunca responde 404 por empresa no encontrada.