Swagger is a framework for describing your API using a common language that everyone can understand .Think of it as a blueprint for a house.
Swagger reduces the manual work out of API documentation, provides a range of solutions for generating, visualizing and maintaining API docs.
You can use whatever building materials you like, but you can’t step outside the parameters of the blueprint.
For millions of people to communicate, there needs to be a common vocabulary.
Documentation from your API design
Our API’s functionality is quite inevitable but maintaining the API doc is not that difficult. Swagger tool takes the hard work of generating and maintaining your API doc, ensuring your documentation is up-to-date as your API evolves.
Swagger Editor
- A swagger editor is open source editor to design, define and document RESTful API in the Swagger Specification.
- The editor works in any browser, can be hosted locally or accessed from the web.
- Editor uses YAML format.
Advantages Of Swagger
- Runs Anywhere: Editor works in any development environment, be it locally or on the web.
- Instant visualization: Renders you API specification visually and interact with your API while you are still defining it.
- Fully Customizable: Easy to customize and configure anything, from line spacing to themes.
- Smart Feedback: Validate your syntax as you write it with concise feedback and error handling.
- Intelligent Auto-completion: It writes syntax faster with a smart and intelligent auto-completion.
- All about your build: Generates server stubs and client libraries for your API in every popular language.
- It’s comprehensible for developers and non developers: Product managers, partners and even potential clients can have input into the design of your API, because they can see it clearly mapped out in this friendly UI.
- It’s human readable and machine readable: This means that its not only shared with your team internally, but the same documentation can be used to automate API-dependent processes.
- It’s easy adjustable: This makes it great for testing and debugging API problems.
References:
https://blog.readme.io/what-is-swagger-and-why-it-matters/
