Convert OpenAPI spec from JSON to YAML

IMHO YAML is much easier to read while we are discussing each endpoint.

Signed-off-by: Piotr P. Karwasz <[email protected]>

Author: ppkarwasz