The Dev Portal uses the Swagger Aggregator to make all your OpenAPI specifications, even the ones spread across different projects, available in a unique place.
As mentioned here, the version of your api-portal needs to be at least 1.14 in order to configure the api documentation correctly.
Configure the API Documentation in Try/View Mode
The API documentation can be configured in two possible ways:
- Try Mode: allows users to interact with the APIs the Dev Portal application expose;
- View Mode: allows users only to visualize the available APIs and their specifications.
By default, the Dev Portal application configures the API documentation in view mode.
If you wish to change this behavior, you can modify the
configuration.json file of the
dev-portal-micro-lc-backend microservice in the design area of the console.
You should be able to find the API documentation plugin configuration:
"label": "API Documentation",
"icon": "fas fa-code",
isViewMode boolean field to switch between one of the two aforementioned configurations.
Merge the APIs of multiple projects
To include specifications from different projects, you can import them by URL using the Advanced section of the Design Area of the Console.
Check the Swagger Aggregator Advanced Config for more details.
Remember to set appropriate request and limits levels to the Swagger Aggregator microservice in order to avoid performance issues.
Check out the dedicated section for more information regarding requests and limits.