Réponse.

Le versionnage des API (Interface de Programmation d'Application) aide à faire évoluer les interfaces et à garantir la rétrocompatibilité lors des changements, afin que les clients externes et internes ne soient pas affectés par chaque mise à jour.

Les principales méthodes de versionnage :

• Versionnage par URL : /api/v1/resource.
• Versionnage par en-tête : Accept: application/vnd.company.v1+json.
• Versionnage par paramètres de requête : /api/resource?version=2.

On utilise généralement l'approche avec la version dans l'URL, car elle est claire et transparente pour tous les clients.

Exemple en Node.js (Express) :

// Version 1
app.get('/api/v1/orders', ordersV1Handler);
// Version 2
app.get('/api/v2/orders', ordersV2Handler);

Caractéristiques clés :

• Permet d'évoluer le produit sans risque pour les utilisateurs des anciens clients.
• Assure une transition en douceur entre les générations d'API.
• Essentiel pour les grandes entreprises et les systèmes publics.

Questions pièges.

Est-il suffisant de toujours maintenir uniquement la dernière version de l'API ?

Non, les utilisateurs d'anciennes applications peuvent ne pas avoir la possibilité de passer rapidement à la nouvelle interface, c'est pourquoi plusieurs versions actuelles sont souvent maintenues.

Peut-on ajouter des changements incompatibles dans une version mineure de l'API ?

Non, les versions mineures doivent être strictement compatibles avec les précédentes. Les changements de rupture nécessitent un changement de version majeure.

Le mode de versionnage (URL, en-têtes, paramètres) influence-t-il la sécurité ou la performance de l'API ?

Non, l'emplacement du stockage de la version n'influence pas les caractéristiques techniques, mais le versionnage par URL est plus facile à analyser par les outils de surveillance et de support.