Gestion des versions
La version 1 de l’API publique se trouve sous /api/public/v1. Cette page indique ce qui peut changer à l’intérieur et comment un changement qui casserait votre intégration vous parvient.
Des ajouts uniquement, à l’intérieur d’une version
Section intitulée « Des ajouts uniquement, à l’intérieur d’une version »Les changements à l’intérieur de la version 1 sont uniquement des ajouts : nouvelles opérations, nouveaux champs facultatifs et nouvelles valeurs d’énumération. Concevez votre intégration pour accepter les champs de réponse et les valeurs d’énumération qu’elle ne connaît pas.
Un changement incompatible est publié sous un nouvel espace de noms, /api/public/v2, à côté de la version 1, qui continue de répondre jusqu’à sa date de fin.
Dépréciation
Section intitulée « Dépréciation »Une opération appelée à disparaître est d’abord marquée comme dépréciée, au moins 90 jours avant son retrait, ou 30 jours pour une opération marquée beta. À partir de là, chacune de ses réponses porte trois en-têtes :
| En-tête | Signification |
|---|---|
Deprecation | Quand l’opération a été dépréciée |
Sunset | Quand elle cesse de répondre |
Link | Un lien vers cette page, avec rel="deprecation" |
Le journal des modifications de l’API consigne chaque dépréciation et chaque nouvelle opération.