The horarios service manages individual schedule entries that link a teacher (Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Luisanchez0/modulo_Horario/llms.txt
Use this file to discover all available pages before exploring further.
docente), a subject (materia), a classroom (aula), and an academic period (periodo) to a specific day and time slot. It runs on port 8004 and delegates identity checks to the usuarios service on port 8001 — all write operations require an ADMIN JWT.
Base URL: http://localhost:8004
Authentication
Read operations (GET) are public — no token is required. All write operations (POST, PUT, DELETE) and the generation endpoint require an Authorization: Bearer <token> header where the decoded rol claim equals ADMIN.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
GET | /horarios | None | List all schedule entries with resolved names |
POST | /horarios | ADMIN | Create a single schedule entry |
PUT | /horarios/{horario_id} | ADMIN | Replace a schedule entry |
DELETE | /horarios/{horario_id} | ADMIN | Delete a schedule entry |
POST | /horarios/generar | ADMIN | Auto-generate schedules for a period |
GET | /periodos | None | List all academic periods |
GET | /periodos/{periodo_id} | None | Get one academic period |
POST | /periodos | ADMIN | Create an academic period |
DELETE | /periodos/{periodo_id} | ADMIN | Delete a period (fails if schedules exist) |
Upstream dependencies
The horarios service makes internal HTTP calls to three catalog services when resolving or validating schedule data:- usuarios-service (port 8001) — validates JWTs and fetches teacher shift information
- materias-service (port 8002) — validates subject IDs
- aulas-service (port 8003) — validates classroom IDs
502 Bad Gateway.
Pages in this section
- Create, update, and delete schedule entries — CRUD endpoints for individual
horariorecords - Auto-generate schedules —
POST /horarios/generarwith constraint-aware assignment