Référence transverse
Versioning & deprecation
Versionning par préfixe URL, préavis de sunset 90 jours minimum.
- Les ressources publiques sont versionnées via le préfixe d'URL (
/api/v1/...). - Une route marquée
deprecated: truedans l'OpenAPI continue de fonctionner mais ne sera pas étendue. Utilisez la version annoncée dans sondescription=. - Préavis de sunset : 90 jours minimum pour les changements visibles, 6 mois pour les renommages structurants. Annoncé via
Deprecation/Sunsetheaders (RFC 8594) une fois la date arrêtée. - Les annonces de dépréciation sont notifiées par e-mail aux contacts techniques des espaces clients concernés et publiées dans le changelog public (à venir).

