Implement swagger docs for our api

[quocble]

https://swagger.io/docs/

We should be able to annotate & autogenerate from on our code.