Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Bryacg/Adutem/llms.txt

Use this file to discover all available pages before exploring further.

El endpoint de autenticación de ADUTEM valida las credenciales del usuario (correo + contraseña) contra la base de datos y, si son correctas, establece una cookie de sesión httpOnly en el navegador.

​
POST /api/auth/login

Autentica un usuario y establece la sesión. Parámetros del cuerpo (JSON):
​
correo
string
required
Correo electrónico del usuario (único en el sistema, ej. docente@utm.edu.ec)
​
contraseña
string
required
Contraseña del usuario en texto plano
Ejemplo de solicitud: 
curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"correo": "docente@utm.edu.ec", "contraseña": "mi_contraseña"}'
Respuesta exitosa (200): 
{
  "success": true,
  "message": "Inicio Exitoso",
  "usuario": {
    "id": 1,
    "correo": "docente@utm.edu.ec",
    "persona": {
      "id": 1,
      "nombre": "Juan",
      "apellido": "Pérez",
      "cedula": "1300000001"
    }
  }
}
Respuestas de error:
CódigoMensajeCausa
401Correo no registradoEl correo no existe en la base de datos
401Contraseña incorrectaLa contraseña no coincide
500Mensaje de error internoError en el servidor
Cookie establecida en respuesta exitosa:
CookieValorOpciones
usuario_idID del usuario (string)httpOnly, sameSite: lax, path: /

​
GET /api/auth/login

Retorna la lista de todos los usuarios registrados en el sistema. 
curl http://localhost:3000/api/auth/login
Respuesta (200): 
{
  "userr": [
    { "id": 1, "correo": "docente@utm.edu.ec", "persona_id": 1 }
  ]
}
Este endpoint devuelve todos los usuarios sin filtrado. Úsalo solo en contextos administrativos.

​
GET /api/auth/login/cache

Retorna los datos del usuario actualmente autenticado a partir de la cookie usuario_id. Útil para verificar la sesión activa desde el cliente. 
curl http://localhost:3000/api/auth/login/cache \
  --cookie "usuario_id=1"
Respuesta exitosa (200): 
{
  "usuario": {
    "nombre": "Juan",
    "apellido": "Pérez",
    "correo": "jperez@utm.edu.ec"
  }
}
Respuestas de error:
CódigoCausa
401No hay cookie usuario_id presente
404El usuario de la cookie no existe en la base de datos
500Error interno del servidor

​
POST /api/auth/logout

Cierra la sesión del usuario eliminando la cookie usuario_id. 
curl -X POST http://localhost:3000/api/auth/logout \
  --cookie "usuario_id=1"
Respuesta (200): 
{
  "success": true,
  "message": "Sesión cerrada"
}
Después del logout, la cookie usuario_id es eliminada del navegador. El usuario deberá autenticarse nuevamente para acceder al sistema.

Build docs developers (and LLMs) love

Get started for freeTalk to us