From the course: Building APIs with Swagger and the OpenAPI Specification
Unlock the full course today
Join today to access over 22,500 courses taught by industry experts or purchase this course individually.
OpenAPI Specification - REST Tutorial
From the course: Building APIs with Swagger and the OpenAPI Specification
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…
Practice while you learn with exercise files
Download the files the instructor uses to teach the course. Follow along and learn by watching, listening and practicing.