eclipse / microprofile-open-api

Microprofile open api
Apache License 2.0
131 stars 81 forks source link

Question on multiple OpenAPI definitions #555

Closed aerfus closed 1 year ago

aerfus commented 1 year ago

Hello,

is there a way to defined multiple OpenAPI definitions, so in UI you will have a combobox to display selected definition only?

See https://quarkus.io/blog/stylish-api/#other-swagger-ui-options as an example.

Thank you in advance!

MikeEdgar commented 1 year ago

MicroProfile OpenAPI supports generating one definition per application, but you could still reference an external definition using the configurations from your link (assuming you're using Quarkus).

aerfus commented 1 year ago

Hi MikeEdgar,

thank you for the answer. Still, is it possible to hide certain tags/controllers in the generated definition?

MikeEdgar commented 1 year ago

@aerfus , you can look at using the following properties to exclude packages or classes

If you need to exclude operations/methods you will probably need to implement an OASFilter, configured with mp.openapi.filter.

aerfus commented 1 year ago

Hi @MikeEdgar, Thanks!