Generate an API spec

We should be able to use the collection of generated schemas to generate an always up-to-date API spec. This spec would be used to generate API clients and maybe even documentation.

This looks like promising format: https://swagger.io/specification/