Document your API using Swagger

Swagger in all it’s simplicity is a framework used to represent and describe your Restful API’s.

Why would we want to use Swagger?
Swagger is in my opinion a good tool for closing the gap between documentation and implementation when developing our RESTful API’s. Used to its full extent, we get a nice sense of control given that we are able to explicitly declare both what the server expects to receive being called, as well as when the request have been handled, what we expect to be returned.

Swagger also provides an additional way of simplifying and describing our API with Swagger-ui, which adds a graphical user interface based on our swagger configuration. This provides us not only with a good overview of our specification, but some really intuitive handling for test purposes. […]

Read More