You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-1
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
# ASP.NET API Versioning
4
4
5
-
ASP.NET API versioning gives you a powerful, but easy-to-use method for adding API versioning semantics to your new and existing REST services built with ASP.NET. The API versioning extensions define simple metadata attributes that you use to describe which API versions are implemented by your services. You don't need to learn any new routing concepts or change the way you implement your services in ASP.NET today.
5
+
ASP.NET API versioning gives you a powerful, but easy-to-use method for adding API versioning semantics to your new and existing REST services built with ASP.NET. The API versioning extensions define simple metadata attributes and conventions that you use to describe which API versions are implemented by your services. You don't need to learn any new routing concepts or change the way you implement your services in ASP.NET today.
6
6
7
7
The default API versioning configuration is compliant with the [versioning semantics](https://github.com/Microsoft/api-guidelines/blob/master/Guidelines.md#12-versioning) outlined by the [Microsoft REST Guidelines](https://github.com/Microsoft/api-guidelines). There are also a number of customization and extension points available to support transitioning services that may not have supported API versioning in the past or supported API versioning with semantics that are different from the [Microsoft REST versioning guidelines](https://github.com/Microsoft/api-guidelines/blob/master/Guidelines.md#12-versioning).
8
8
@@ -12,4 +12,10 @@ The supported flavors of ASP.NET are:
12
12
*[ASP.NET Web API and OData](https://www.nuget.org/packages/Microsoft.AspNet.OData.Versioning) - Adds service API versioning to your Web API applications using OData v4.0
13
13
*[ASP.NET Core](https://www.nuget.org/packages/Microsoft.AspNetCore.Mvc.Versioning) - Adds service API versioning to your ASP.NET Core applications
14
14
15
+
This is also the home of the ASP.NET API versioning API explorers that you can use to easily document your REST APIs with Swagger:
16
+
17
+
*[ASP.NET Web API Versioned API Explorer](https://www.nuget.org/packages/Microsoft.AspNet.WebApi.Versioning.ApiExplorer) - Replaces the default API explorer in your Web API applications
18
+
*[ASP.NET Web API with OData API Explorer](https://www.nuget.org/packages/Microsoft.AspNet.OData.Versioning.ApiExplorer) - Adds an API explorer to your Web API applications using OData v4.0
19
+
*[ASP.NET Core Versioned API Explorer](https://www.nuget.org/packages/Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer) - Adds additional API explorer support to your ASP.NET Core applications
20
+
15
21
You can find samples, documentation, and getting started instructions in the [wiki](https://github.com/Microsoft/aspnet-api-versioning/wiki).
0 commit comments