7-Swagger refactor

[piapip]

Just saying that there're some flaws in the Swagger branch. The Documenting RESTful APIs with Swagger.
But it's quite helpful actually since it really makes me dive deep into the code and read everything three, four times.