Superfasttt
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: true dans l'OpenAPI continue de fonctionner mais ne sera pas étendue. Utilisez la version annoncée dans son description=.
  • Préavis de sunset : 90 jours minimum pour les changements visibles, 6 mois pour les renommages structurants. Annoncé via Deprecation / Sunset headers (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).