API Documentation - Sistema MAC

🔐 Authentication Endpoints

POST /api/auth/login/

Iniciar sesión con número de cuenta

{
  "account_number": "12345678"
}

GET /api/auth/profile/ AUTH

Obtener perfil del usuario autenticado

POST /api/auth/token/refresh/

Refrescar access token

POST /api/auth/logout/

Cerrar sesión del usuario

📅 Events Endpoints

GET /api/events/

Listar todos los eventos activos

GET /api/events/{id}/

Obtener detalles de un evento específico

✅ Attendance Endpoints

POST /api/attendance/ AUTH

Registrar asistencia a un evento (solo asistentes)

{
  "event_id": 1,
  "account_number": "12345678"
}

GET /api/attendance/stats/?account_number=12345678 AUTH

Obtener estadísticas de asistencia de un estudiante

GET /api/attendance/my/?account_number=12345678 AUTH

Obtener lista de asistencias del estudiante

GET /api/attendance/recent/ AUTH

Obtener asistencias recientes (solo asistentes)

🔑 Authentication

La API utiliza JWT (JSON Web Tokens) para autenticación.

Para endpoints que requieren autenticación, incluye el header:

Authorization: Bearer <your_access_token>

Flujo de autenticación:

Envía tu número de cuenta a /api/auth/login/
Recibe access_token y refresh_token
Usa el access_token en el header de las peticiones
Cuando expire (1 hora), usa el refresh_token en /api/auth/token/refresh/

⚙️ System Configuration

GET /api/auth/system-config/ AUTH

Obtener configuración del sistema (% mínimo, tiempos de registro, etc.)

📖 Quick Links

ℹ️ Response Codes

Code	Descripción
`200`	Petición exitosa
`201`	Recurso creado exitosamente
`400`	Petición inválida (error en datos)
`401`	No autenticado
`403`	Sin permisos
`404`	Recurso no encontrado
`500`	Error del servidor

📚 API Documentation