OpenAPI Specification

The OpenAPI Specification, originally known as the Swagger Specification, is a specification for machine-readable interface files for describing, producing, consuming, and visualizing RESTful Web services - wikipedia

A variety of tools can generate code, documentation and test cases given an interface file. Development of the OpenAPI Specification (OAS) is overseen by the Open API Initiative, an open source collaborative project of the Linux Foundation.

# 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 - wikipedia

# Features

The OpenAPI Specification is language-agnostic. It is also extensible into new technologies and protocols beyond HTTP - wikipedia

With OpenAPI's declarative resource specification, clients can understand and consume services without knowledge of server implementation or access to the server code.

# Tools that work with OpenAPI

The Open API Initiative maintains a list of implementations for version 3.0 of the specification. Unofficial lists also exist - wikipedia

# See also

# Sections