Documentando aplicações REST com SpringBoot e Swagger
You can execute following command or as you prefer download zip here and import in your favourite IDE.
git clone https://github.com/leandrocgsi/simple-rest-example-swagger.git
Swagger is a simple but powerful representation of your RESTful API. With the largest ecosystem of API tooling on the planet, thousands of developers are supporting Swagger in almost every modern programming language and deployment environment. In January 1st 2016 the Swagger Specification has been donated to the Open API Initiative (OAI) and has been renamed to the OpenAPI Specification. With a Swagger-enabled API, you get interactive documentation, client SDK generation and discoverability. In this example you can see the documentation API in localhost adress:
http://localhost:8080/sdoc.jsp
As you can see Swagger provide a simple way to document US API's.