Learn Swagger and the Open API Specification (Udemy.com)

API Definition Files, Tools, and Documentation (OAS 2.0)

( 219 Reviews )

Created by: Peter Gruenbaum

Produced in 2021

What you will learn

Read and write Open API Specification (Swagger) files to define and document APIs
Use Swagger tools to edit files, create documentation, and create SDKs
Understand alternatives to Swagger and OAS.

Quality Score

Content Quality

Video Quality

Qualified Instructor

Course Pace

Course Depth & Coverage

Overall Score : 86 / 100

Course Description

The Open APISpecification (often called "Swagger")is currently the most popular way to create definitions of RESTful APIs. With these definitions, you can create sophisticated, autogenerated documentation, generate SDKs in several languages, and doautomated testing. Swagger is a set of open source tools that use these Open APISpecification definition files.
This class is for people in the software industry who are fairly technical, but are not software developers:
for example,project managers, APIproduct managers, and technical writers. It assumes that you understand REST and JSON, but that's about all. It is meant to be for people who are new to the Open APISpecification and Swagger, rather than for experts.
It covers:
What you can do with Open APISpecification (OAS)filesThe YAMLfile formatHow to create an OASfileHow to specify securityHow to add documentationHow to write an OAS file in JSONAlternatives to Swagger and OASThis class doesnot cover:
How to set up Swagger on your own serverHow to modify Swagger open sourcecodeIn addition to videos, this course contains 8 hands-on exercises that lead you step-by-step in creating an APIdefinition file, including a final project where you create a file from scratch using documentation from an actual commercial API. It also contains a document with resources on learning more about OAS, Swagger, and alternatives.
In addition to the video lectures, expect to spend at least 4 hours doing the exercises. These exercises are key to understanding Swagger and OAS.
Important: The course uses OAS 2. A newer version, OAS3, is starting to be used more, but many companies are still using OAS2. There is a lecture that points you to the differences between OAS 2 and OAS3.
Who this course is for:
Anyone who wants to be able to read or write Open API Specification (Swagger) filesProject managersTechnical writersTechnical sales staffTechnically-skilled managers

Time: 1 hour on-demand videoh

Instructor Details

Peter Gruenbaum

4.3 Rating
219 Reviews

Peter founded SDK Bridge to bring together his love of technology and writing. After 10 years as a software developer, he learned the skill of API writing at Microsoft. Since then, he has worked as an API writer to describe APIs for eCommerce, automobile traffic prediction, electric utilities, mobile phones, and tractors, just to name a few. In addition to API and SDK documentation, he creates video tutorials for software developer audiences. Peter received his BA in Physics from the University of Chicago and his PhD in Applied Physics from Stanford University.