API Versioning
Le versionnage d'API gère les changements d'interface pour que les nouvelles versions ne cassent pas les anciens clients, communément via chemin URL, en-têtes ou paramètres de requête.
Objectif
Gérer l'évolution de l'API, garantissant la rétrocompatibilité et une migration fluide.
Mécanisme
Chemin URL : /v1/users (explicite, simple). En-tête : Accept: application/vnd.api+json;version=1 (RESTful). Query : ?version=1. Versionnage sémantique : major casse compatibilité, minor ajoute, patch corrige. Anciennes versions dépréciées avec période de transition.
Cas d’usage
- Gestion d'API
- Rétrocompatibilité
- Évolution de versions