Swashbuckle.webapi: Unable to Generate different Swagger URLs for individual apis across different controllers

[maheshmohandas]

Hello,

I am having an ASP.NET Web API MicroServices project wherein I have a root project and other projects in my solution. All the projects in the solution contains multiple controllers and each controller contains several apis.

I would like to know whether we can generate separate swagger URL for the individual apis. This is because I need to import them to Azure API Gateway one by one rather than importing them as a whole. Below is the structure of my project. Currently the Swashbuckle library generates a single Swagger URL for all the apis in the project.

Solution
Project A
Controller 1
API - 1 GET
API - 2 POST
API - 3 GET

Project B
Controller 2
API - 1 GET
API - 2 POST
API - 3 GET

In this case I want the individual swagger DOC url of each api so that I can add them to the API Gateway. I want to manage each individual api in the gateway portal rather than adding them all together. Is there a way I can achieve this.

Thanks a lot in advance.

[domaindrivendev]

Currently, you can only create separate documents for different versions of an API (see https://github.com/domaindrivendev/Swashbuckle#describing-multiple-api-versions).

Arbitrary grouping is not currently supported but is definitely something I'll be looking at for the next major version.

[Marusyk]

any news about that?

[domaindrivendev]

There is now a separate project specifically for ASP.NET Core and this supports arbitrary grouping of API actions into multiple Swagger documents:

https://github.com/domaindrivendev/Swashbuckle.AspNetCore#generate-multiple-swagger-documents

Of course this is only available if you've moved your application to ASP.NET Core. I don't plan on implementing it in this, WebAPI-specific, version but you do have some options. Check out #764 for some ideas

[healmoto]

Hello everyone, I cannot believe there is no way to create an individual Swagger UI per each version.

I am waiting so much time on it. How did you guys tackle this ?

@maheshmohandas @Marusyk