Versionnement

• Préfixe /v1. Toutes les routes de l'API sont sous /v1 (hors /health).
• Une campagne par calculateur. L'année fait partie du slug : impot-revenu-2025 et impot-revenu-2026 sont deux calculateurs, chacun avec les règles de sa campagne. incomeYear donne l'année des revenus.
• Années closes à part. Un calcul sur une campagne passée applique les règles de cette campagne, jamais celles d'une campagne plus récente.
• version (dans GET /v1/calculators et dans chaque réponse de calcul) est la version sémantique de la DÉFINITION du calculateur (formulaire, graphe, sorties) ; elle change quand la définition change.
• rulesVersion (dans chaque réponse de calcul) liste les modules de calcul appliqués avec leur version : c'est la trace de la règle exacte qui a produit le résultat. Gardez-la avec un résultat que vous conservez.
• Le document OpenAPI est servi par GET /v1/openapi.json. Il est généré depuis les schémas des routes et vérifié par les tests à chaque modification : il décrit toujours l'API du déploiement qui le sert. GET /v1/openapi.json?locale=en sert le même document, descriptions en anglais.

La politique de dépréciation et le journal public des changements seront fixés avant l'ouverture de l'API aux développeurs (phase 5 de la feuille de route).