EDC API Wrapper: SwaggerUI in dev

[richardtreier]

Feature

Description

We'd like to serve a bit more than just the technical openapi.yaml in our EDC so customers may explore the API in an interactive way.

While the SwaggerUI might be the simplest, a good Postman Collection might replace it.

Potential Solutions

• Serve OpenApi Yaml as endpoint
• Swagger UI might be easier:
  • Serve a Swagger UI in DEV that simply shows our OpenAPI YAML.
• Postman might be better, but would have to be manually kept:
  • Our customers like to use Postman collections instead of the Swagger UI
  • Check if it is possible to serve a postman collection instead of an OpenAPI YAML file.
  • Postman collections might be better built by humans. Check if we need one.