We should investigate OpenAPI and Swagger https://github.com/go-swagger/go-swagger
OpenAPI will be investigated in another ticket