[Tech debt] API versioning — ajouter /api/v1/ #37

New issue

Open

opened 2026-08-05 15:42:15 -04:00 by NixCyRy · 0 comments

NixCyRy commented

2026-08-05 15:42:15 -04:00

(Migrated from github.com)

Problème

Tous les endpoints sont sous /api/ sans versioning. Le jour où un breaking change est nécessaire (changement de schéma, format de réponse), tous les clients en production cassent simultanément.

Solution recommandée

Prefix tous les Blueprints avec /api/v1/
Garder un redirect temporaire /api/xxx → /api/v1/xxx pour la rétrocompatibilité
Documenter la politique de déprécation (ex: 2 versions simultanées max)

Effort

Minimal — c'est un rename de strings dans app.py + url_prefix des Blueprints. Plus c'est fait tôt, moins il y a de endpoints à migrer.

Priorité

P3-low — pas urgent, mais le coût augmente avec le temps.

## Problème Tous les endpoints sont sous `/api/` sans versioning. Le jour où un breaking change est nécessaire (changement de schéma, format de réponse), tous les clients en production cassent simultanément. ## Solution recommandée 1. Prefix tous les Blueprints avec `/api/v1/` 2. Garder un redirect temporaire `/api/xxx → /api/v1/xxx` pour la rétrocompatibilité 3. Documenter la politique de déprécation (ex: 2 versions simultanées max) ## Effort Minimal — c'est un rename de strings dans `app.py` + `url_prefix` des Blueprints. Plus c'est fait tôt, moins il y a de endpoints à migrer. ## Priorité P3-low — pas urgent, mais le coût augmente avec le temps.