Add OpenAPI description for API

**Is your feature request related to a problem? Please describe.**
A future client would have to guess our endpoints and formats. This is not ideal. ;)

**Describe the solution you'd like**
Add an OpenAPI description of the API

**Describe alternatives you've considered**
none

**Additional context**
none
