Create draft of OpenAPI documentation

[ingoboerner]

I drafted an OpenAPI documentation, ignore the responses for now: https://gist.github.com/ingoboerner/3799ded26d5815d3b0ee821889cf22c6 can be viewed in https://editor.swagger.io/