Details
-
Feature Request
-
Resolution: Fixed
-
L3 - Default
-
None
-
None
Description
Component
https://github.com/camunda/camunda-bpm-platform/tree/master/distro/run
User story
I want to access an instance of Swagger UI (https://swagger.io/tools/swagger-ui/) with Camunda's OpenAPI description (https://docs.camunda.org/manual/7.13/reference/rest/openapi/) so that I can easily explore the REST API without having to switch platforms.
Background
Currently I need to download the JSON from Camunda and put it into a third-party tool. This is cumbersome.
Acceptance Criteria
- When I start Run without arguments, the Swagger UI is automatically exposed displaying the Camunda REST API endpoints (must be mentioned in update guide as well, since it changes the default behavior)
- The Swagger UI is configured by default such that it can directly make requests against Run's REST API without further user configuration
- There is a startup argument with which I can toggle Swagger UI (similar to how it works for REST API and webapps: https://docs.camunda.org/manual/7.13/user-guide/camunda-bpm-run/#disable-webapps-or-rest-api)
Implementation hints
- If achievable with moderate effort, the Swagger UI classes should not be in the classpath when Swagger UI is disabled