Creating your own OAS
Now that you have seen what an OAS file is like, let’s look at what it takes to create your own. Creating your own file from scratch will give you a better idea of how the specification works. The example below will just skim over what it takes to create an OpenAPI specification. If you want more details on this, you can check out the documentation here: https://swagger.io/docs/specification/about/. OpenAPI specifications can be written in either JSON or YAML format. It is common to use YAML so that is what I will use in the coming example.
In this section, I will walk you through creating an API specification for an imaginary budgeting application. This application will allow users to add new line items to a budget. It will also allow users to update entries once they have been created.
They can also delete an item that they no longer want to track. Our job in this section will be to create an API specification that lays out exactly what this...