Si vous n'utilisez toujours pas de langage de définition pour les spécifications d'API lisibles par machine, comme OpenAPI (anciennement connu sous le nom de Swagger), vous devriez certainement envisager de le faire. Après tout, les API sont des langages permettant aux machines de communiquer entre elles.
Est-ce que Swagger est une bonne idée ?
Swagger fait une très bonne première impression De plus, beaucoup de gens pensent que la possibilité de générer du code à partir de la documentation est une bonne idée et Swagger fournit cela aussi bien. Ainsi, le fait que l'arrogance fasse une bonne première impression rend ses limites et ses contraintes moins apparentes.
Quel est le but d'utiliser Swagger ?
Swagger vous permet de décrire la structure de vos API afin que les machines puissent les lire. La capacité des API à décrire leur propre structure est à l'origine de toutes les merveilles de Swagger.
Est-ce que Swagger est toujours utilisé ?
Aujourd'hui, de nombreux utilisateurs utilisent encore les termes " Swagger" pour faire référence au format de spécification OpenAPI 2.0, et "Swagger spec" pour faire référence à un document de description d'API dans ce format. RepreZen API Studio utilise ces termes dans certaines parties de l'interface utilisateur, mais fait référence à OpenAPI 3.0 et aux versions ultérieures en tant qu'« OpenAPI ».
Est-ce que swagger est uniquement pour l'API REST ?
OpenAPI Specification (anciennement Swagger Specification) est un format de description d'API pour les API REST. Un fichier OpenAPI vous permet de décrire l'intégralité de votre API, y compris: les points de terminaison disponibles (/users) et les opérations sur chaque point de terminaison (GET /users, POST /users)