a6-recipe-api-versioning

Overview

API versioning allows you to evolve your API without breaking existing clients. APISIX supports multiple versioning strategies through routing rules, header matching, and traffic splitting — all configurable via the a6 CLI.

Strategies covered:

1. URI path versioning — /v1/users, /v2/users
2. Header-based versioning — Accept: application/vnd.api.v2+json
3. Query parameter versioning — ?version=2
4. Gradual migration — weighted traffic split between versions
5. Version deprecation — redirect old versions to new

When to Use