Pourquoi une stratégie de gestion des versions d'API est importante

Gestion des API Azure

Fiodar Sazanavets

Senior Software Engineer at Microsoft

Introduction à la gestion des versions d'API

Intro à la gestion des versions

Analogie de gestion des versions

Utilisées quand des changements majeurs dérouteraient les usagers
Pendant que la nouvelle ligne est construite, on continue d'utiliser l'ancienne
Les révisions sont comme l'entretien de la même ligne
- Réparer les rails, ajouter de la signalisation, rendre le trajet plus fluide
Dans APIM :
- Les versions vivent dans un version set
- Les révisions permettent d'éditer, tester et marquer une révision comme courante

Trois stratégies d'indication de version sont prises en charge :
- Version déclarée dans le chemin d'URL
- Version indiquée dans l'en-tête de requête
- Version indiquée dans la chaîne de requête d'URL
La stratégie de versionnage doit être uniforme

Version dans le chemin d'URL

Version dans l'en-tête

Version dans la chaîne de requête

Diffusion canari

Résultats :
- Si la rétroaction est bonne -> marquer la révision comme courante
- Si elle est mauvaise -> revenir à la révision précédente

Comme en cuisine : servir une nouvelle recette à quelques tables d'abord
Dans APIM :
- Créer une nouvelle révision et la tester en privé
- L'exposer à un public restreint (produit pilote ou sous-ensemble d'appelants)
- Cibler une révision précise via une URL spéciale avec son numéro
Métaphore ferroviaire : les testeurs prennent la « voie d'entretien » sans toucher à la ligne principale

Gestion des API

Gestion des API Azure