Roll Swagger for API documentation

[jaredbriskman]

No description provided.

[jaredbriskman]

This is now in place with 1b1d65f. It could certainly use a little more TLC, specifically more descriptions and good example values, but it seems quite serviceable now.

Open questions include whether this should be enabled in prod, and what the version scheme of the API should be, like in #142. Currently, the version is specified as 0.1.

Also, moving the API resources to separate namespaces seems to have broken most of the travis tests, need to investigate more. It looks like the flask self.get is 404ing on endpoints which work when actually deployed.

Besides that, ready to open a PR, I think.

[jaredbriskman]

Turns out tests were broken due to case sensitive URL mismatch, fixed in 7335ca6.

Upon further inspection of the flask-restplus framework, it looks like we can't easily use the resource models to serialize to mongo, meaning this creates near duplication of document models and resource models. The resulting interactive documentation is quite excellent though.