api swagger definition
 Version actuelle - 2.0. La version actuelle de la spécification OpenAPI est la 2.0 – et vous pouvez la trouver ici. Ce référentiel contient la spécification Swagger 1.2 existante ainsi que des propositions pour la version 2.0. Comme promis dans mon article précédent, je vais vous montrer comment écrire une définition d'API au format OpenAPI Spécification (anciennement Swagger Spécification). Ce tutoriel sera composé de plusieurs articles :  Le framework d'API le plus populaire au monde. Excellente nouvelle pour la communauté Swagger ! Depuis le 1er janvier 2016, la spécification Swagger a été donnée à l'Open API Initiative (OAI) et constitue le fondement de la spécification OpenAPI. Swagger est une représentation simple mais puissante de votre API RESTful. Avec le plus grand écosystème d'outils API de la planète, des milliers de développeurs prennent en charge Swagger dans presque tous les langages de programmation et environnements de déploiement modernes.  Cela nécessite cependant que les capacités du service soient décrites dans la structure de la spécification OpenAPI. Tous les services ne peuvent pas être décrits par OpenAPI : cette spécification n'est pas destinée à couvrir tous les cas d'utilisation possibles d'une API REST-ful. Vois ici. L'objectif de la spécification OpenAPI est de définir une interface standard indépendante du langage pour les API REST qui permet aux humains et aux ordinateurs de découvrir et de comprendre les capacités du service sans accès au code source, à la documentation ou via une inspection du trafic réseau.  Swagger-Codegen contient un moteur basé sur des modèles pour générer de la documentation, des clients API et des stubs de serveur dans différentes langues en analysant la définition OpenAPI/Swagger.  Les cas d'utilisation des interfaces API lisibles par machine incluent la documentation interactive, la génération de code pour la documentation, le client et le serveur, ainsi que les cas de test automatisés. Les API compatibles OpenAPI exposent les fichiers JSON qui adhèrent correctement à la spécification OpenAPI, documentée dans ce référentiel. Une interface puissante pour votre API. Swagger est une représentation simple mais puissante de votre API RESTful. Avec le plus grand écosystème d'outils API de la planète, des milliers de développeurs prennent en charge Swagger dans presque tous les langages de programmation et environnements de déploiement modernes.  Comme promis dans mon article précédent, je vais vous montrer comment écrire une définition d'API au format OpenAPI Spécification (anciennement Swagger Spécification). Cette première partie explique ce qu'est la spécification OpenAPI, pourquoi vous allez l'utiliser et quels outils vous pouvez utiliser pour rédiger ces spécifications.  Pourquoi utiliser un langage de définition d'API tel que la spécification OpenAPI ? L'utilisation d'un langage de définition d'API tel que la spécification OpenAPI permet de décrire facilement et rapidement une API. C'est particulièrement utile lorsque vous êtes dans le processus de conception de votre API (cf. mon premier article de la série).
 Swagger est une représentation simple mais puissante de votre API RESTful.