| 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 |
| Strategy | URL path (/api/v1/) | | Support window | Current + 1 previous | | Deprecation notice | 3 months minimum | | Sunset period | 6 months after deprecation | | Breaking changes | New major version | | Additive changes | Same version (backward compatible) |
url-versioning Keywords: url version, path version, /v1/, /v2/ Solves:
Strategie di controllo delle versioni API tra cui percorso URL, intestazione e negoziazione del contenuto. Da utilizzare durante la migrazione da v1 a v2, la gestione di modifiche sostanziali, l'implementazione di policy di deprecazione o cessazione o la gestione della compatibilità con le versioni precedenti. Fonte: yonatangross/skillforge-claude-plugin.