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)files

• The YAMLfile format

• How to create an OASfile

• How to specify security

• How to add documentation

• How to write an OAS file in JSON

• Alternatives to Swagger and OAS

This class doesnot cover:

• How to set up Swagger on your own server

• How to modify Swagger open sourcecode

In 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.