One of the consistent concerns of API providers is the experience they provide to their users and how they can make their API documentation user friendly, interactive, intuitive and clear.
At 3scale when we are asked how to make it faster and easier for developer to interact with an API without hesitation we say “Swagger”
Swagger is a powerful Open Source Framework enabling API documentation and exploration in a friendly and easy way. It lets developers learn, play, test and debug every single element of your API and makes their life simpler when it comes to developing apps. Swagger is an improved version of an API Console.
You can download the Swagger framework from http://swagger.wordnik.com/.
Swagger Framework Overview
Swagger is an improvement on existing specs like WSDL 2.0 and WADL which must support legacy systems in order to be generally accepted.
- Automated, consistent generation of clean, beautiful, interactive API documentation
- Generation of client code and SDK in multiple languages
- Feeding into an industry wide API discovery language that both developers and non-developers can use