Publish and maintain OpenAPI schema

[jvican]

It would become much easier to use this API if there were OpenAPI schema or bindings that we could use to autogenerate code in any language, rather than encouraging a manual and error-prone API client implementation.

Have you explored creating this schema and making it available in this repository? It would be of great help. I was able to find https://gist.github.com/yujixr/92247f90ca9ca1bfb62da753c43fb4e1 but I don't know how up-to-date it is.