Extend OpenAPI specification to cover full metadata schema

The OpenAPI integration merged in #86 contains a rudimentary specification for external consumers of our metadata. It should be extended to document all of our metadata and afterwards kept synchronized as we change our internal representation.