We recently covered speeding your restful api development with Swagger. The article is really clear on how to use swagger, and I would suggest you read it first before going through this. The article however starts with an API from scratch. But this may not be the case for some of us.
Full article