Swagger & RESTful Web service
Swagger is an open source software framework backed by a large
ecosystem of tools that helps developers design, build, document, and
consume RESTful Web services. While most users identify Swagger by the Swagger UI tool, the Swagger
toolset includes support for automated documentation, code generation,
and test case generation.
The Swagger API project was created in 2011 by Tony Tam, Technical co-founder of the dictionary site Wordnik. During the development of Wordnik's products, the need for automation of API documentation and client SDK generation became a major source of frustration. Tam designed a simple JSON representation of the API, building upon the flexibility of the REST style of architecture and using many features of tooling built for the SOAP protocol. The concept for the user interface was proposed by Ayush Gupta who suggested that an interactive user interface would benefit end users who wished to "try out" and develop against the API. Ramesh Pidikiti led implementation of the initial code generator and designer/developer Zeke Sikilianos coined the name Swagger. The Swagger API project was made open source in September, 2011. Soon after release, a number of new components were added to the project, including a stand-alone validator, support for node.js, and ruby on rails.
In Swagger's early years, modest traction came from small companies and independent developers. RESTful APIs typically did not have a machine-readable description mechanism, and Swagger provided a simple and discoverable way to do so. Tam was invited to a meeting with some of the API industry's thought leaders including John Musser (Programmable Web), March Gardiner (Apigee, now a Google product), Marco Palladino (Mashape), and Kin Lane (API Evangelist) to discuss a standardization effort around API descriptions. While the meeting did not yield a concrete plan to do so, it put Swagger on the map as a critical innovation in the API space.
Helped by the use of the Apache 2.0 open-source license, a number of products and online services began including Swagger in their offerings, which accelerated quickly after adoption by Apigee, Intuit, Microsoft, IBM and others who began to publicly endorse the Swagger project.
Shortly after Swagger was created, alternative structures for describing RESTful APIs were introduced, the most popular being API Blueprint in April 2013 and RAML in September 2013. While these competing products had stronger financial backing than Swagger, they initially focused on different use cases from Swagger, and as of mid 2014, Swagger interest was growing more quickly than the combination of the two others [source: Google Trends].
In November 2015 SmartBear Software, the company that maintained Swagger, announced that it was helping create a new organization, under the sponsorship of the Linux Foundation, called the Open API Initiative. A variety of companies, including Google, IBM and Microsoft are founding members.[1].
On 1-January 2016 the Swagger specification was renamed to OpenAPI Specification, and was moved to a new repository in GitHub. While the specification itself was not changed, this renaming signified the split between the API description format and the open source tooling.
https://github.com/OAI/OpenAPI-Specification
https://smartbear.com/
https://swaggerhub.com/
As of July, 2017, Swagger tools are downloaded over 100,000 times per day, according to hosting repositories Sonatype and NPM.
From: https://en.wikipedia.org/wiki/Swagger_(software)
The Swagger API project was created in 2011 by Tony Tam, Technical co-founder of the dictionary site Wordnik. During the development of Wordnik's products, the need for automation of API documentation and client SDK generation became a major source of frustration. Tam designed a simple JSON representation of the API, building upon the flexibility of the REST style of architecture and using many features of tooling built for the SOAP protocol. The concept for the user interface was proposed by Ayush Gupta who suggested that an interactive user interface would benefit end users who wished to "try out" and develop against the API. Ramesh Pidikiti led implementation of the initial code generator and designer/developer Zeke Sikilianos coined the name Swagger. The Swagger API project was made open source in September, 2011. Soon after release, a number of new components were added to the project, including a stand-alone validator, support for node.js, and ruby on rails.
In Swagger's early years, modest traction came from small companies and independent developers. RESTful APIs typically did not have a machine-readable description mechanism, and Swagger provided a simple and discoverable way to do so. Tam was invited to a meeting with some of the API industry's thought leaders including John Musser (Programmable Web), March Gardiner (Apigee, now a Google product), Marco Palladino (Mashape), and Kin Lane (API Evangelist) to discuss a standardization effort around API descriptions. While the meeting did not yield a concrete plan to do so, it put Swagger on the map as a critical innovation in the API space.
Helped by the use of the Apache 2.0 open-source license, a number of products and online services began including Swagger in their offerings, which accelerated quickly after adoption by Apigee, Intuit, Microsoft, IBM and others who began to publicly endorse the Swagger project.
Shortly after Swagger was created, alternative structures for describing RESTful APIs were introduced, the most popular being API Blueprint in April 2013 and RAML in September 2013. While these competing products had stronger financial backing than Swagger, they initially focused on different use cases from Swagger, and as of mid 2014, Swagger interest was growing more quickly than the combination of the two others [source: Google Trends].
In November 2015 SmartBear Software, the company that maintained Swagger, announced that it was helping create a new organization, under the sponsorship of the Linux Foundation, called the Open API Initiative. A variety of companies, including Google, IBM and Microsoft are founding members.[1].
On 1-January 2016 the Swagger specification was renamed to OpenAPI Specification, and was moved to a new repository in GitHub. While the specification itself was not changed, this renaming signified the split between the API description format and the open source tooling.
https://github.com/OAI/OpenAPI-Specification
https://smartbear.com/
https://swaggerhub.com/
As of July, 2017, Swagger tools are downloaded over 100,000 times per day, according to hosting repositories Sonatype and NPM.
From: https://en.wikipedia.org/wiki/Swagger_(software)
评论
发表评论