Endpoints
Todos los endpoints protegidos requieren el header X-API-Key. El healthcheck es público.
| Método | Ruta | Descripción | Auth |
|---|---|---|---|
| GET | /health | Healthcheck público | Pública |
| GET | /estudiantes | Listado paginado con búsqueda y filtros | API Key |
| GET | /estudiantes/{id} | Estudiante por ID | API Key |
| GET | /estudiantes/by-dni/{dni} | Estudiante por DNI exacto | API Key |
| GET | /estudiantes/buscar/dni/{dni} | Búsqueda parcial por DNI | API Key |
| GET | /estudiantes/buscar/nombre/{nombre} | Búsqueda por nombre | API Key |
| GET | /estudiantes/buscar/apellido/{apellido} | Búsqueda por apellido | API Key |
| POST | /estudiantes/buscar | Búsqueda avanzada con body JSON | API Key |
| GET | /estudiantes/aleatorio | Devuelve un estudiante aleatorio | API Key |
| GET | /facultades | Listar facultades con conteos | API Key |
| GET | /facultades/{slug} | Detalle de una facultad | API Key |
| GET | /facultades/{slug}/escuelas | Escuelas de una facultad | API Key |
| GET | /escuelas | Listar escuelas | API Key |
| GET | /escuelas/{slug} | Detalle de una escuela | API Key |
| GET | /estadisticas | Estadísticas generales | API Key |
¿Por qué usar esta API?
⚡ Rápida de integrar
Endpoints REST con respuestas JSON limpias. Solo necesitas una API Key para empezar.
🔍 Búsquedas flexibles
Busca por nombre, apellido, DNI parcial, facultad o escuela. Ideal para buscadores y filtros.
🐳 Lista para producción
Dockerizada con PostgreSQL. Despliega en Coolify, Railway o cualquier VPS en minutos.
Autenticación
Incluye tu API Key en el header X-API-Key en cada petición. Sin ella recibirás 403 Forbidden.
X-API-Key: cambia-esta-api-key-en-produccion