From the course: Building APIs with Swagger and the OpenAPI Specification

Unlock the full course today

Join today to access over 22,600 courses taught by industry experts or purchase this course individually.

OpenAPI Specification

OpenAPI Specification - REST Tutorial

From the course: Building APIs with Swagger and the OpenAPI Specification

Start my 1-month free trial

OpenAPI Specification

“

- [Instructor] When working with Swagger, understanding the purpose of the OpenAPI Specification, or OAS, can be one of the toughest concepts to grasp. However, it's critical to your success, because Swagger tooling is centered around the OpenAPI specification. I'm going to provide you with clear understanding on why OAS exists, and its importance, so that you can be successful with Swagger. Here is how the OpenAPI specification describes itself within its own documentation. In a nutshell, OAS defines how we describe the interface of a RESTful API, regardless of the language in which it's built. That's still a little abstract, so let's dive a little deeper. Here we see a rough description of a REST API interface. A REST API interface exposes endpoints or operations that clients can use to access API resources. So here we see an API with three endpoints that expose operations on a single resource named product. A client sends an http call to invoke these operations on the API. Some of…

Contents