Chapitre 6 - Documenter avec OpenAPI
Lire un contrat OpenAPI
Pendant la chasse au trésor, vous avez découvert API-ritif à tâtons, en lisant les réponses une p...
Structure YAML et schémas
YAML en 30 secondes YAML est un format de données lisible, basé sur l'indentation (des espaces, j...
Code-first ou design-first
Le contrat et le code doivent dire la même chose. Mais lequel écrit-on en premier ? Code-first O...
Swagger UI, Redoc et Scalar
Un contrat en YAML, c'est précis mais austère. Des outils le transforment en une documentation ag...
Générer des clients
Un contrat OpenAPI est lisible par les machines. Elles peuvent donc écrire à votre place le code ...