OpenAPI Specification

From Wikipedia, the free encyclopedia

The OpenAPI Specification, previously known as the Swagger Specification, is a specification for machine-readable interface files for describing, producing, consuming, and visualizing RESTful web services.[1] Previously part of the Swagger framework, it became a separate project in 2016, overseen by the OpenAPI Initiative, an open-source collaboration project of the Linux Foundation.[2] Swagger and some other tools can generate code, documentation, and test cases given an interface file.

History[]

Swagger development began in early 2010 by Tony Tam, who was working at online dictionary company Wordnik.[3] After a meetup talk with Kin Lane (OpenAPI Steering committee) and Tony Tam on June 12, 2014,[4] Kin Lane approached Owen Rubel who was working on a similar approach and borrowed his ideas for the new Swagger 2.0 spec (which would eventually become OpenAPI).[5]

In March 2015, SmartBear Software acquired the open-source Swagger API specification from Reverb Technologies, Wordnik's parent company.[6]

In November 2015, SmartBear announced that it was creating a new organization called the OpenAPI Initiative under the sponsorship of the Linux Foundation. Other founding member companies included 3scale, Apigee, Capital One, Google, IBM, Intuit, Microsoft, PayPal, and Restlet.[7][8][9] SmartBear donated the Swagger specification to the new group. RAML and API Blueprint were also under consideration by the group.[10][11]

On 1 January 2016, the Swagger specification was renamed the OpenAPI Specification (OAS), and was moved to a new GitHub repository.[12]

In September 2016, the API World conference presented an API Infrastructure award to SmartBear for its ongoing work on Swagger.[13]

In July 2017, the OpenAPI Initiative released version 3.0.0 of its specification.[14] MuleSoft, the main contributor to the alternative RESTful API Modeling Language (RAML), joined the OAS and open-sourced their API Modeling Framework tool, which can generate OAS documents from RAML input.[15]

In February 2021, the OpenAPI Initiative released version 3.1.0.[16] Major Changes In OpenAPI Specification 3.1.0 include JSON Schema vocabularies alignment, New top-level element for describing Webhooks that are registered and managed out of band, Support for identifying API licenses using the standard SPDX identifier, and PathItems object is now optional to make it simpler to create reusable libraries of components.[17][18][19]

Release dates[]

Version Date Notes[20]
3.1.0 2021-02-15 Release of the OpenAPI Specification 3.1.0
3.0.3 2020-02-20 Patch release of the OpenAPI Specification 3.0.3
3.0.2 2018-10-08 Patch release of the OpenAPI Specification 3.0.2
3.0.1 2017-12-06 Patch release of the OpenAPI Specification 3.0.1
3.0.0 2017-07-26 Release of the OpenAPI Specification 3.0.0
2.0 2014-09-08 Release of Swagger 2.0
1.2 2014-03-14 Initial release of the formal document
1.1 2012-08-22 Release of Swagger 1.1
1.0 2011-08-10 First release of the Swagger Specification

Usage[]

Applications implemented based on OpenAPI interface files can automatically generate documentation of methods, parameters and models. This helps keep the documentation, client libraries, and source code in sync.[21]

Features[]

The OpenAPI Specification is language-agnostic. With OpenAPI's declarative resource specification, clients can understand and consume services without knowledge of server implementation or access to the server code.[21]

Tools that work with OpenAPI[]

The OpenAPI Initiative maintains a list of implementations for version 3.0 of the specification. SmartBear still brands its OpenAPI tools with the Swagger moniker. The Swagger UI framework allows both developers and non-developers to interact with the API in a sandbox UI that gives insight into how the API responds to parameters and options. Swagger can handle both JSON and XML.[21]

Swagger Codegen contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing the OpenAPI definition. In July, 2018, William Cheng, the top contributor to Swagger Codegen, and over 40 other contributors to Swagger Codegen forked the code into a project named OpenAPI Generator under the OpenAPI Tools organization.[22] [23]

Annual Conference[]

The OpenAPI Initiative sponsors an API Specifications Conference (ASC) annually. The event has its origins in the API Strategy and Practice Conference (APIStrat) which ran for many years and became part of the OpenAPI Initiative in 2016.

See also[]

References[]

  1. ^ "Linux Foundation wants to extend Swagger in connected buildings | Business Cloud News". Archived from the original on 6 May 2016. Retrieved 22 April 2016.
  2. ^ "OpenAPI Initiative Charter". OpenAPI Initiative. Retrieved 12 November 2019.
  3. ^ "Swagger creator joins SmartBear". Retrieved 6 August 2019.
  4. ^ "API Design Panel". Retrieved 6 August 2019.
  5. ^ "Kin Lane Confesses To Borrowing OpenAPI ideas from separate project". Retrieved 6 August 2019.
  6. ^ "SmartBear Assumes Sponsorship of Swagger API Open Source Project". SmartBear. Retrieved 25 March 2015.
  7. ^ "FAQ". OpenAPI Initiative. Retrieved 12 November 2019.
  8. ^ "SmartBear, Linux Foundation launch Open API Initiative to Evolve Swagger". ProgrammableWeb. 10 November 2015. Retrieved 21 April 2016.
  9. ^ "New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services". www.linuxfoundation.org. Archived from the original on 27 April 2016. Retrieved 22 April 2016.
  10. ^ Montcheuil, Yves de. "In 2016, the need for an API meta-language will crystallize". InfoWorld. Retrieved 25 April 2016.
  11. ^ "Amazon API Gateway Now Supports Swagger Definition Import". InfoQ. Retrieved 25 April 2016.
  12. ^ OpenAPI Initiative. "OpenAPI Specification". GitHub. Retrieved 12 November 2019.
  13. ^ "Swagger wins the 2016 API Award for API Infrastructure". Swagger Blog. Retrieved 27 July 2018.
  14. ^ "The OAI Announces the OpenAPI Specification 3.0.0". OpenAPIs. Retrieved 19 April 2018.
  15. ^ "The HTTP API space is Consolidating around OAS". InfoQ. Retrieved 14 May 2017.
  16. ^ "OpenAPI Specification 3.1.0 Available Now". Linux.com. Retrieved 26 April 2021.
  17. ^ "What's New in OpenAPI 3.1.0?". Nordic APIs. Retrieved 7 April 2021.
  18. ^ "OpenAPI Specification 3.1.0 Released". OpenAPI Initiative. Retrieved 18 February 2021.
  19. ^ "Migrating from OpenAPI 3.0 to 3.1.0". OpenAPI Initiative. Retrieved 16 February 2021.
  20. ^ [b "OpenAPI Specification Version 3.0.4"]. Retrieved 23 April 2020. {{cite web}}: Check |url= value (help)
  21. ^ a b c "swagger-api/swagger-spec". GitHub. Retrieved 1 December 2015.
  22. ^ "Swagger Codegen is now OpenAPI Generator". Retrieved 6 August 2019.
  23. ^ "Swagger Codegen Fork: Q&A". Retrieved 6 August 2019.

Bibliography[]

  • Haupt, F.; Karastoyanova, D.; Leymann, F.; Schroth, B. (2014). A Model-Driven Approach for REST Compliant Services. ICWS 2014. 2014 IEEE International Conference on Web Services. pp. 129–136. doi:10.1109/ICWS.2014.30. ISBN 978-1-4799-5054-6.
  • Pautasso, Cesare (2021). Beautiful APIs. LeanPub. p. 100.

External links[]

Retrieved from ""