Posts

Showing posts from October, 2015

Swagger ( An easy way to document your Rest API) Tutorial

Image
Hi, In this blog, I will share how you can use Swagger to document your Rest services/api. Swagger is an open source software that can come handy and is easy to use/configure if you are looking to document your Rest APIs. During development with multiple developers in a distributed team it can also come handy to have a visibility on Rest Services developed by Team. This article will focus on basic configuration.For sample JSON Rest web service have referred to an example from http://avaldes.com/spring-restful-web-service-example-with-json-and-jackson-using-spring-tool-suite/. It's a good site with info. Step-1: Make sure you have a Restful webservice up and running. I tried using an example from http://avaldes.com/spring-restful-web-service-example-with-json-and-jackson-using-spring-tool-suite/ It can be downloaded from http://avaldes.com/?wpdmdl=4550 so before we move forward,check http://localhost:8080/<context-name>/issuers is returning a JSON response. Step-2