How to Implement API Versioning for Minimal APIs | ASP.NET Core 8

API versioning allows your API to evolve independently from the clients using it. Introducing breaking changes to your API is a bad user experience. API versioning gives you a mechanism to avoid exposing breaking changes to clients. Instead of making a breaking change, you introduce a new API version. Today, I'll show you how to implement API versioning in ASP.NET Core.

API Versioning in ASP.NET Core

Join my weekly .NET newsletter:

Read my Blog here:

Chapters
0:00 Why is API Versioning important?
1:43 Different kinds of API Versioning
3:17 Configuring API Versioning in .NET 8
6:38 Adding API Versioning to Minimal APIs
11:04 How API Versioning works in practice
13:15 Fixing Swagger UI and API Versioning
17:05 API Versioning and Functional tests

[codeme]

Very clear. Some tutorials aren't but this one was outstanding. Thank you!

[XelleczixTV]

Love your videos! A little tip: you should increase the volume of your mic 😊 Have to turn up quite a lot to hear you clearly.

[raiscl]

Could we all as a group drop the X on custome headers? It's been more than a decade that this is not mandatory anymore and it is actually advised against! Besides, just polute code on FE and BE....

a part of that. Amazing tutorial!!

[nhfgsew]

I didn't see much about the vlogs of the day in the life of dotnet developers, How much they can make, what kind of companies require them and future of dotnet. Please you make

[ferventurart]

When a video about how add open api summary, description, params and responses (documenting our endpoints)

[xmshvwo]

Not being able to have XML comments like controllers, unhappy

[xentricator]

@MilanJovanovicTech how would you implement this kind of versioning when the seperate versions have a different contract (which is usually the reason why you would create another version, due to it being a different contract often results in breaking changes). Currently in your example you are always routing to the same implementation with the same contract whether it's v1 or v2.

[xmshvwo]

CreateUser API, there is only one V1 version, but the V2 version of SwaggerUI also appears, how to make the V2 version not displayed?

[vishalpawarsblogs]

when we define route with `v{v:apiVersion}/controller`, how default version will work?
how will work in such case?

[abhikr_]

Content of the video is too good and I always learn something new from your videos but you haven’t talk about the breaking changes in this video. Is there a new video coming for breaking changes or missed it if I missed that concept can you please provide the timestamp.

Thanks 😊

[kyamcollados]

hey man, i tried to follow your tutorial and i got stuck in the swagger ui page. i could not see the v2 in the dropdown. anything i missed?

[bzgtoqi]

hey milan thanks. did you try with version 8.1.0? it will say that the swagger endpoint is not found

[jithin.johnson]

when using Carter, how to implement versioning?

[aamirali]

why dont you provide code to learn your one concept we have fill up the blank of incomplete code which take more time and we move to another syllabus and forget why we started this thing

[Paul-uosv]

Can we have one vid for non minimal apis?

[andyhb]

When using the version number as part of the route can you still use Postman to import the OpenAPI as I'm only seeing the v1 assuming it was part of the same issue as the swagger UI I tried adding the swagger gen option configuration elements but it still only returns version 1?

[andyhb]

Is it possible that there is an issue when using Carter to register map the endpoints, I have setup a Test endpoint with 2 versions and when I call it I get... Duplicate endpoint name 'Testing' found on 'HTTP: GET => Logout' and 'HTTP: GET => Logout'. Endpoint names must be globally unique.

[chrissu]

hi，good vid,
there's a little question
which is the theme was?
really awesome theme
plz name for me~ thx.

[salmanshafiq]

Very informative❤
What is customresults here?

[Yehor-Lesnevych]

Hey! I have an issue with swagger and api versioning. I did all the steps in the video but calling app.DescribeApiVersions() throws exception "System.FormatException: 'Input string was not in a correct format.'"