⚙️ API publique

API publique en lecture seule : jours fériés, vacances scolaires et événements (France, Chablais, Genève, Vaud, Valais). Limite : 120 requêtes/minute/IP. Réponses JSON UTF-8, dates ISO 8601 (heure locale Europe/Paris ou Europe/Zurich).

Spécification OpenAPI 3.1 : /api/openapi.json

Exemples

Réponses paginées : { "data": [...], "meta": { "total", "page", "pageSize", "pages" } }. Erreurs : { "error": "message" } avec le code HTTP adapté (400, 404, 429…).

GET/api/events

Événements, fêtes et saisons (paginé)

Paramètre	Type	Description
from	string	Date de début (AAAA-MM-JJ)
to	string	Date de fin incluse (AAAA-MM-JJ, période ≤ 800 jours)
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`
inherit	0 \| 1	1 (défaut) : inclut les éléments des territoires parents (ex. fériés nationaux pour le Chablais) ; 0 : strict
category	string	Catégories (voir /api/categories), séparées par des virgules — ex. `jour-ferie,vacances-scolaires`
type	string	event, holiday, school, observance, season
importance	string	LOW, NORMAL, HIGH, CRITICAL (liste)
minImportance	LOW \| NORMAL \| HIGH \| CRITICAL	Importance minimale
municipality	string	Commune (slug, voir /api/municipalities) — ex. `thonon-les-bains`
zone	string	Zones de vacances : A, B, C, GE, VD, VS (défaut : A, GE, VD, VS)
q	string	Recherche texte (titre, description, commune…)
page	integer
pageSize	integer

GET/api/events/{slug}

Détail d'un événement

Paramètre	Type	Description
slug *	string

GET/api/events/{slug}/ics

Un événement au format iCalendar

Paramètre	Type	Description
slug *	string

GET/api/calendar

Vue unifiée (événements + fériés + vacances) sur une période

Paramètre	Type	Description
from	string	Date de début (AAAA-MM-JJ)
to	string	Date de fin incluse (AAAA-MM-JJ, période ≤ 800 jours)
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`
inherit	0 \| 1	1 (défaut) : inclut les éléments des territoires parents (ex. fériés nationaux pour le Chablais) ; 0 : strict
category	string	Catégories (voir /api/categories), séparées par des virgules — ex. `jour-ferie,vacances-scolaires`
type	string	event, holiday, school, observance, season
importance	string	LOW, NORMAL, HIGH, CRITICAL (liste)
minImportance	LOW \| NORMAL \| HIGH \| CRITICAL	Importance minimale
municipality	string	Commune (slug, voir /api/municipalities) — ex. `thonon-les-bains`
zone	string	Zones de vacances : A, B, C, GE, VD, VS (défaut : A, GE, VD, VS)
q	string	Recherche texte (titre, description, commune…)

GET/api/holidays

Jours fériés

Paramètre	Type	Description
year	integer	— ex. `2027`
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`

GET/api/school-holidays

Vacances scolaires

Paramètre	Type	Description
from	string	Date de début (AAAA-MM-JJ)
to	string	Date de fin incluse (AAAA-MM-JJ, période ≤ 800 jours)
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`
zone	string	Zones de vacances : A, B, C, GE, VD, VS (défaut : A, GE, VD, VS)

GET/api/categories

Catégories

GET/api/regions

Territoires

GET/api/municipalities

Communes

Paramètre	Type	Description
region	string

GET/api/search

Recherche globale

Paramètre	Type	Description
q *	string
limit	integer

GET/api/stats

Densité annuelle (événements par jour / mois)

Paramètre	Type	Description
year	integer
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`
inherit	0 \| 1	1 (défaut) : inclut les éléments des territoires parents (ex. fériés nationaux pour le Chablais) ; 0 : strict
category	string	Catégories (voir /api/categories), séparées par des virgules — ex. `jour-ferie,vacances-scolaires`
type	string	event, holiday, school, observance, season
importance	string	LOW, NORMAL, HIGH, CRITICAL (liste)
minImportance	LOW \| NORMAL \| HIGH \| CRITICAL	Importance minimale
municipality	string	Commune (slug, voir /api/municipalities) — ex. `thonon-les-bains`
zone	string	Zones de vacances : A, B, C, GE, VD, VS (défaut : A, GE, VD, VS)
q	string	Recherche texte (titre, description, commune…)

GET/api/export/{format}

Export filtré (ics, csv, json) — l'URL ICS sert d'abonnement

Paramètre	Type	Description
format *	ics \| csv \| json
from	string	Date de début (AAAA-MM-JJ)
to	string	Date de fin incluse (AAAA-MM-JJ, période ≤ 800 jours)
country	string	Pays : france, suisse (ou FR, CH), séparés par des virgules — ex. `france`
region	string	Régions : chablais, haute-savoie, france, geneve, vaud, valais, chablais-valaisan, suisse — ex. `chablais`
inherit	0 \| 1	1 (défaut) : inclut les éléments des territoires parents (ex. fériés nationaux pour le Chablais) ; 0 : strict
category	string	Catégories (voir /api/categories), séparées par des virgules — ex. `jour-ferie,vacances-scolaires`
type	string	event, holiday, school, observance, season
importance	string	LOW, NORMAL, HIGH, CRITICAL (liste)
minImportance	LOW \| NORMAL \| HIGH \| CRITICAL	Importance minimale
municipality	string	Commune (slug, voir /api/municipalities) — ex. `thonon-les-bains`
zone	string	Zones de vacances : A, B, C, GE, VD, VS (défaut : A, GE, VD, VS)
q	string	Recherche texte (titre, description, commune…)
name	string	Nom de l'agenda (ICS)

GET/api/health

État du service