ASP.NET Core Web API Interview Question #84
What is API versioning?
Routing, Versioning, OpenAPI/Swagger & API Documentation Mid-Level Intermediate
Quick Interview Answer
API versioning allows an API to evolve while maintaining defined contracts for clients that still depend on older behavior. Different versions may expose different request models, response models, routes, or semantics.
Detailed Explanation
API versioning allows an API to evolve while maintaining defined contracts for clients that still depend on older behavior. Different versions may expose different request models, response models, routes, or semantics.
Versioning should be introduced deliberately. Not every internal code change requires a new public API version; a new version is most relevant when a client-facing contract changes incompatibly.
Code Example
GET /api/v1/products/10
GET /api/v2/products/10
// v2 can evolve the public contract while
// v1 remains available during a transition.