Versions et OpenAPI

Développez avec le contrat explicite /api/v1 et le document OpenAPI téléchargeable.

Version de l'API

Version de l’API: La version de l'URL identifie le contrat public de l'API.
Version d’Engine: Le numéro de version Engine dans OpenAPI identifie l'implémentation ayant exporté le document ; il ne s'agit pas de l'expected_version d'une ressource.
Version de la ressource: Les versions des ressources métier servent au contrôle de concurrence et doivent provenir des réponses actuelles.

Conservez le contrat téléchargé avec vos tests d'intégration.
Vérifiez les champs obligatoires, les valeurs d'énumération et les schémas de réponse lors des mises à jour.