Creating your own Specification File

Now that you have seen what an OpenAPI specification 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 down with either json or yaml formats. It is common to use yaml and do 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 to-do list application. This application will allow users to create new to-do items. It will also allow users to mark those items as complete and to make changes to the item after they have created it. They can also delete an item that they no longer want to track. Our job in this section will...