La version majeure est dans l'URL : /v1/.... Elle ne change qu'avec un
changement cassant de l'ensemble de l'API.
Il n'y a pas d'autre mécanisme de version. Un en-tête X-API-VERSION a
été annoncé ici ; il est accepté mais ignoré : n'en dépendez pas.
Les évolutions sont publiées dans le changelog, chacune
avec ce qu'elle change et ce que votre intégration doit faire. Un ajout (un
champ, un filtre, une route) n'est jamais signalé autrement que là : votre
client doit ignorer les champs qu'il ne connaît pas. Un changement cassant
est nommé comme tel, avec une date et la marche à suivre.