v10.2.0
What's Changed
This release introduces API version aliasing support, making it easier for API clients to specify versions using shorter or alternative semantic version formats.
API Version Aliasing:
- Added
ApiVersionAliasParserthat resolves friendly API version aliases (such as1,1.0, or1.0.0) to canonicalSemanticApiVersioninstances, with intelligent fallback to another parser. This enables clients to use shortened version tokens instead of requiring fully-qualified semantic versions. - Enhanced
AddRestfulApiVersioningto automatically register semantic version aliases when the default API version is aSemanticApiVersion, reducing the need for manual parser configuration. - Added
AddApiVersionParser<T>extension method for registering customIApiVersionParserimplementations as singletons, giving you fine-grained control over version parsing behavior.
Testing & Quality:
- Introduced a new functional test project (
Codebelt.Extensions.Asp.Versioning.FunctionalTests) with comprehensive test coverage for semantic version compatibility and alias routing. - Added tests validating that API endpoints correctly route requests using various semantic version formats and production/non-production behaviors.
Sources:
- V10.2.0/support api alias by @gimlichael and @aicia-bot in #34
- V10.2.0/changelog by @gimlichael in #35
Full Changelog: v10.1.0...v10.2.0