Introduction to OpenAPI Specification

When creating an API, the first task is to define it. This is done using the standard OpenAPI specification, which was formerly known as the Swagger specification. Currently, Frends supports OpenAPI 2.0 and OpenAPI 3.0 in both JSON and YAML formats.

The OpenAPI definition can be created manually or by using a graphical OpenAPI design tool, such as Stoplight, to design the API specification and then import the definition into Frends.

In this course, we won't go into all the details of the OpenAPI specification, nor will we use OpenAPI design tools. Instead, we will cover the most important parts with examples. The full OpenAPI 3.0 specification is freely available at Swagger.

The next article is OpenAPI 2.0 or OpenAPI 3.0