Building RESTful APIs? Great - API consumers love them if the right design decisions were made. And we need to make a lot of design decisions when building a new API. How do we capture these decisions, gain an overview, communicate the decisions and iterate on the design?
To describe APIs in a precise manner, API designers typically use API description languages. They offer specialized language concepts to capture design decisions. Thus, API description languages can be called the power tools of the API designer.
One of the most popular API description languages is Swagger and OpenAPI. In this quick guide, we will learn how Swagger/OpenAPI can be used to capture your RESTful API design decisions.