Creating OASes

I won't spend a lot of time on the Swagger tools that are used for OASes, but I do want to give you at least an introduction to the subject so that you can use these tools in your API testing if you want. In this section, you will learn how to create and edit OASes in the Swagger Editor. You will also learn what an API schema is and how to codify one in an API specification. In order to demonstrate these things, I will use the Swagger Petstore API. This is an example API that already has the OAS built for it. It is a good way to get started with using OpenAPI and is used in their documentation a lot as well.

The OAS enables a lot of value, but there is quite a bit to it as well. In this section, I will quickly skim through using it. I will also develop these themes more deeply by working through some more examples in Chapter 11, Designing an API Specification.

The Swagger Editor is an online tool for editing the OAS. You can access it at https://editor.swagger...