API Chiffrette
Trois jeux de données sur le calendrier français, en JSON. Pas de clé, pas d’inscription, pas de quota : ce sont des fichiers statiques servis par le même hébergement que le site. Libres de réutilisation, y compris commerciale ; un lien vers chiffrette.com fait plaisir sans être exigé.
Jours fériés
GET /api/jours-feries/{annee}.json
Les onze jours fériés légaux français d’une année, avec leur jour de la semaine, s’ils tombent un week-end, et s’ils sont mobiles. Les deux jours propres au droit local d’Alsace-Moselle figurent à part.
- Années disponibles
- 2024 à 2030
- Exemple
- /api/jours-feries/2026.json
Semaines ISO
GET /api/semaines/{annee}.json
Les 52 ou 53 semaines ISO 8601 d’une année, avec la date du lundi, celle du dimanche et la parité. Les semaines de début et de fin d’année débordent sur l’année civile voisine, ce que les dates montrent.
- Années disponibles
- 2024 à 2030
- Exemple
- /api/semaines/2026.json
Vacances scolaires
GET /api/vacances-scolaires/{annee-scolaire}.json
Les vacances des zones A, B et C pour une année scolaire, d’après les arrêtés du ministère. Premier jour de vacances, dernier jour, et jour de rentrée, pour éviter l’ambiguïté habituelle.
- Années disponibles
- 2025-2026, 2026-2027, 2027-2028
Un exemple de réponse
{
"annee": 2026,
"zone": "France métropolitaine",
"jours": [
{
"date": "2026-01-01",
"nom": "Jour de l’an",
"jourSemaine": "jeudi",
"weekend": false,
"mobile": false
},
{
"date": "2026-04-06",
"nom": "Lundi de Pâques",
"jourSemaine": "jeudi",
"weekend": false,
"mobile": true
}
]
} Extrait de /api/jours-feries/2026.json.
S’en servir
const r = await fetch('https://chiffrette.com/api/jours-feries/2026.json');
const { jours } = await r.json();
console.log(jours.map((j) => `${j.date} ${j.nom}`));
L’en-tête Access-Control-Allow-Origin: * est servi sur tout /api/ : l’appel
fonctionne depuis un navigateur, sur n’importe quel domaine. Les fichiers sont mis en cache une heure.
Ce que l’API garantit, et ce qu’elle ne garantit pas
Les jours fériés et les semaines ISO sont calculés, pas saisis : les fériés mobiles dérivent de la date de Pâques par l’algorithme de Meeus et Butcher, les semaines suivent la norme ISO 8601. Ces deux jeux sont exacts pour toutes les années publiées et le resteront. Les vacances scolaires, elles, sont saisies à la main depuis les arrêtés du ministère : elles sont justes au jour de la publication, et une modification ministérielle en cours d’année ne serait répercutée qu’à la mise à jour suivante.
Les URL ne bougeront pas
Ce sont des fichiers, pas un service : rien ne tombe en panne, rien n’est facturé, rien n’exige de maintenance. Les adresses ci-dessus sont stables. Si un champ devait changer de forme, un nouveau chemin serait créé à côté plutôt que l’ancien modifié. Une erreur dans les données se signale à l’adresse de contact.
Les mêmes données pour les humains
Les pages jours fériés 2026, numéro de semaine et calendrier 2026 affichent les mêmes données, calculées par le même code. Et la page de téléchargements les donne en fichiers d’agenda, à importer directement.