The OpenAPI Specification , originally known as Swagger Specs, is a specification for machine-readable interface files to describe, produce, consume, and visualize RESTful web services. Various tools can generate code, documentation and test cases given the interface file. OpenAPI Specification Development (OAS) is overseen by the Open API Initiative, an open source collaborative project of the Linux Foundation.
Video OpenAPI Specification
History
Development of firmness began in early 2010. In March 2015, SmartBear Software acquired the Swagger API open source specification from Reverb Technologies.
In November 2015, SmartBear, a company that maintains Swagger's specifications and related tools, announces that it helps create a new organization, under the sponsorship of the Linux Foundation, called the Open API Initiative. Companies, including Google, IBM, and Microsoft are founding members. SmartBear contributed Swagger specifications to the new group. RAML and Blueprint API are also being considered by the group.
On January 1, 2016, Swagger specification was renamed with the OpenAPI Specification, and moved to a new repository in GitHub.
SmartBear continues to develop tools under the Swagger brand to support OpenAPI specifications. In 2016, SmartBear received the API Award in the API Infrastructure category for Swagger.
In July 2017, the OpenAPI Initiative released version 3.0.0 of its specification. MuleSoft, the main contributor to the alternative RESTful API Modeling Language (RAML), joins the OAS and their open source Modeling Framework API tool, which can generate OAS documents from RAML inputs.
Maps OpenAPI Specification
Usage
Applications that are implemented based on OpenAPI interface files can automatically generate method, parameter and model documentation. This helps keep the synchronized documentation, client libraries, and source code.
Features
The OpenAPI specification is language-agnostic. It can also be extended to new technologies and protocols outside HTTP.
With the OpenAPI declarative resource specification, clients can understand and consume services without knowledge of server implementation or access to server code.
Tools that work with OpenAPI
The Open API Initiative maintains a list of implementations for version 3.0 of the specification. Unofficial list also exists.
SmartBear still brand their OpenAPI tool with Swagger moniker.
The UI Swagger framework allows developers and non-developers to interact with APIs in the sandbox UI that provides insight into how APIs respond to parameters and options. Arrogance can handle JSON and XML.
Swagger-Codegen contains template-driven engines to generate documentation, API clients, and stub servers in different languages ​​by parsing OpenAPI definitions.
See also
- Country Transfer Representation
- RESTful API Overview Language description includes RAML, WADL, WSDL, and more.
References
Bibliography
External links
- Open API Initiative (OAI) website
- The arrogant website
- OpenAPI Specification in GitHub
- OpenAPI definition directory
Source of the article : Wikipedia
0 Comments