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
Exemple
/api/vacances-scolaires/2026-2027.json

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.