api-versioning
Installation
SKILL.md
API Versioning Strategies
Design APIs that evolve gracefully without breaking clients.
Strategy Comparison
| Strategy | Example | Pros | Cons |
|---|---|---|---|
| URL Path | /api/v1/users |
Simple, visible, cacheable | URL pollution |
| Header | X-API-Version: 1 |
Clean URLs | Hidden, harder to test |
| Query Param | ?version=1 |
Easy testing | Messy, cache issues |
| Content-Type | Accept: application/vnd.api.v1+json |
RESTful | Complex |