# Politique de versioning de l'API ArcadeOps

Document canonique : https://arcadeops.leadalpes.fr/api-versioning.md

## Version stable

Les routes stables utilisent le préfixe `/api/v1`. Une évolution incompatible est publiée sous un
nouveau préfixe de version. Les ajouts compatibles peuvent être livrés dans la version courante.

## Dépréciation

Une route dépréciée publie `Deprecation: ?1`, un header `Sunset` au format HTTP-date et un lien
`rel="successor-version"` vers son remplacement. Le lien `rel="deprecation"` renvoie vers ce document.

ArcadeOps maintient normalement une période de migration d'au moins six mois entre l'annonce d'une
dépréciation et la date de retrait. Une échéance plus courte est réservée à une urgence de sécurité
et doit être documentée publiquement.

## Comportement attendu des agents

Les agents doivent préférer les routes `/api/v1`, enregistrer les headers `Deprecation` et `Sunset`,
et planifier la migration avant la date annoncée. Ils ne doivent pas contourner une route retirée ni
réessayer une mutation sur un alias historique.