Document the API

[willis7]

It would be awesome if you exposed the API using documentation such as the OpenAPI standard. As the deployment gets more sophisticated it would be good to read docs rather than fire up the service to understand the data.