Holidays

Périodes de vacances scolaires (label + date de début + date de fin), utilisées par les outils de calcul de progression pour ne pas pénaliser les étudiants pendant ces fenêtres.

Source : src/api/v1/holidays.ts, src/db/schema/holidays.schema.ts, src/services/dto/holidays.dto.ts.

Voir aussi le schéma Holiday.

Lister les vacances

GET/api/v1/holidayssource ↗

Réponse `200`

[
  {
    "id": 1,
    "label": "Vacances de Noël 2024",
    "start": "2024-12-21",
    "end": "2025-01-05"
  }
]

Récupérer une période

GET/api/v1/holidays/:idsource ↗

Nom	Type	Localisation	Description
`id`	number	path	ID de la période

Erreurs

Code	Cause
404	Période introuvable

Créer une période

POST/api/v1/holidayssource ↗

Body (JSON)

{
  "label": "Vacances de printemps 2025",
  "start": "2025-04-19",
  "end": "2025-05-04"
}

Champ	Type	Requis	Description
`label`	string	✅	Nom affiché
`start`	date	✅	Début (`YYYY-MM-DD`)
`end`	date	✅	Fin (`YYYY-MM-DD`)

Réponse `201`

L’objet créé.

Mettre à jour une période

PUT/api/v1/holidays/:idsource ↗

Tous les champs du body sont optionnels (cf. UpdateHolidayDTO).

Supprimer une période

DELETE/api/v1/holidays/:idsource ↗

Réponse

204 No Content.

Projects Discord