TheIApiVersionSelector interface defines the behavior of how an API version is selected for a given request context. This service is typically only used when a client has not requested an explicit API version and theAssumeDefaultVersionWhenUnspecified option is enabled. The role of the API version selector is to select the appropriate API version given the current request and a model of available API versions.

Although theIApiVersionSelectorcan be used for other scenarios, it is currently only utilized when no API version is requested by a client and the server allows this behavior. The selector provides the rules thatselect the most appropriate API version according to the server. There is no built-in capability to ignore an API version explicitly requested by a client.

There are four API version selectors provided out-of-the-box or you can implement your own. The default, configured API version selector isDefaultApiVersionSelector.

publicinterfaceIApiVersionSelector{ApiVersionSelectVersion(HttpRequestMessagerequest,ApiVersionModelmodel);}

publicinterfaceIApiVersionSelector{ApiVersion?SelectVersion(HttpRequestrequest,ApiVersionModelmodel);}

TheDefaultApiVersionSelector always selects the configuredDefaultApiVersion, regardless of the request or available API version information.

TheConstantApiVersionSelector always selects a user-defined API version, regardless of the request or available API version information.

services.AddApiVersioning(    options=>options.ApiVersionSelector=newConstantApiVersionSelector(newApiVersion(new(2016,7,1)));

TheCurrentImplementationApiVersionSelector selects the maximum API version available which does not have a version status. If no match is found, it falls back to the configuredDefaultApiVersion. For example, if the versions1.0,2.0, and3.0-alpha are available, then2.0 will be selected because it's the highest, implemented or released API version.

services.AddApiVersioning(    options=>options.ApiVersionSelector=newCurrentImplementationApiVersionSelector(options));

TheLowestImplementedApiVersionSelector selects the minimum API version available which does not have a version status. If no match is found, it falls back to the configuredDefaultApiVersion. For example, if the versions "0.9-Beta", "1.0", "2.0", and "3.0-Alpha" are available, then "1.0" will be selected because it’s the lowest, implemented or released API version. Your services must be decorated with one or more API versions for the selector to work effectively or it will always select the configuredDefaultApiVersion.

services.AddApiVersioning(    options=>options.ApiVersionSelector=newLowestImplementedApiVersionSelector(options));