Gestion des versions
L'API est versionnée sous un préfixe /v1 — voici l'état actuel.
Chaque endpoint est sous /v1
Chaque chemin de cette référence est préfixé par /v1 (/v1/chat, pas /chat). La seule exception est /health,
qui reste volontairement sans préfixe — c'est un contrôle de disponibilité d'infrastructure, pas une partie du
contrat public versionné, et les outils de supervision pointent vers un chemin nu.
L'API publie désormais une spécification OpenAPI lisible par machine — le JSON brut sur /docs-json, et une
interface Swagger interactive sur /docs — générée directement à partir des vrais gestionnaires de route et des
types de requête/réponse réels, si bien qu'elle ne peut pas dériver silencieusement comme un texte écrit à la main
le peut. Cette page reste écrite à la main pour l'instant ; la migrer pour afficher directement la spécification
générée, plutôt que de la décrire à la main, est une prochaine étape naturelle, mais cela n'a pas encore eu lieu.