Swagger, the Interactive API Documentation Framework that Benefits both API Providers and Consumers

Janet Wagner, February 19th, 2013

ReverbLast month ProgrammableWeb reported that Wordnik, a popular online dictionary and provider of the Wordnik API, had launched a brand new company called Reverb. Reverb is home to several developer tools including Swagger, a complete framework for “describing, producing, consuming, and visualizing RESTful web services.” This post is an overview of the Swagger interactive API documentation specification and framework.

Swagger

Swagger makes it possible for API providers to create interactive API documentation where developers can not only learn specifics about an API, but also experiment with, test and debug API calls. Swagger can be implemented in many different ways including Scala, Java, HTML5, JavaScript, Ruby and PHP. The Swagger core is available for download at GitHub.

Automated API documentation that is consistent, easy to read and provides the ability to make live API calls is beneficial to both API providers and API consumers. Thorough, interactive API documentation helps developers better understand and easily consume APIs and also aids in API discovery. For API providers, offering APIs that are easy to understand and consume helps in the promotion of their APIs and can increase the adoption and consumption of their APIs by developers.

3scale is one of the companies that use Swagger to provide interactive API documentation and Swagger is featured in 3scale’s New Open Source API Proxy. In a blog post, 3scale states about Swagger:

“At 3scale when we are asked how to make it faster and easier for developers to interact with an API without hesitation we say Swagger.”

Detailed information about Swagger can be found at Reverb and GitHub.

Both comments and pings are currently closed.

One Response to “Swagger, the Interactive API Documentation Framework that Benefits both API Providers and Consumers”

February 25th, 2013
at 7:14 am
Comment by: Reverb News: Swagger, trademark defense, Downton Abbey

[...] other Swagger news, the Programmable Web took a look at our interactive documentation framework and found that it benefits both API [...]

Follow the PW team on Twitter

ProgrammableWeb
APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.