Skip to content
Chris Martinez edited this page Sep 20, 2018 · 16 revisions
Clone this wiki locally

Versioning is an important aspect of any mature web service. Microsoft has published REST API guidelines that require that all compliant services must support explicit versioning. This ensures that clients can rely on services to be stable over time, while still enabling service changes and new features. Detailed information about the recommended guidance can be found in the Microsoft REST Guidelines.

The goal of the ASP.NET API versioning project is to adhere to the Microsoft REST Guidelines for versioning using the ASP.NET technology stack. Support is provided for the following variations of ASP.NET:

ASP.NET Web API

Everything you need to add service API versioning to your Web API applications and ApiControllers.

ASP.NET Web API and OData

Expands upon the service API versioning for Web API and adds OData-specific features for your OData v4.0 applications and ODataControllers, including support for versioned EDM models.

ASP.NET Core

Everything you need to add service API versioning to your ASP.NET Core applications and Controllers.

ASP.NET Core and OData

Expands upon the service API versioning for ASP.NET Core and adds OData-specific features for your OData v4.0 applications and ODataControllers, including support for versioned EDM models.