What is Swagger?
- A standard way to document REST APIs
- The documentation is described in a YAML or JSON document.
- OpenAPI has syntax and tags to write an API description.
Why Use Swagger?
- Very standard
- It not just describes APIs but also serves as an APIs contract among teams.
- Each API specifies the expected request, response and response codes.
- Along with this, APIs can have examples of sample requests and responses.
Reference
Covert Swagger 2.0 to OpenAPI 3.xx
Written with StackEdit.