search

domaindrivendev / Swashbuckle.WebApi

Seamlessly adds a swagger to WebApi projects!
BSD 3-Clause "New" or "Revised" License
3.07k stars 677 forks source link

swagger-ui multiple API versions #1028

Open Xavina opened 7 years ago

Xavina commented 7 years ago

Hi,

I'm currently developing a multi version WebAPI.

I've choose the following package to do so: https://github.com/Microsoft/aspnet-api-versioning

My question is, which is the best way to have separated swagger-UI pages for each version?

I would like to have something like:

Now I am able to have a 'mixed' UI doc page, with all the controllers, but it is a little confusing for my costumers, I think it would be better to display all the endpoints.

Thanks, Xavi

commonsensesoftware commented 7 years ago

@Xavina did you know that there is an API Explorer for API Versioning to support this now? You can see the Web API sample here. Although it's RC, it's stable. I'm tightening up the last few bits this week and I think things will be ready for the first, official release.