Automatically API documentation with Swagger

[rzhade3]

In order to document the API while we code, rather than having to update the README, or have to communicate over text, we should use a documentation framework. We could use something like Swagger to do this.