| 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:
Стратегии управления версиями API, включая URL-адрес, заголовок и согласование содержимого. Используйте при переходе с версии 1 на версию 2, обработке критических изменений, реализации политик устаревания или прекращения использования или управлении обратной совместимостью. Источник: yonatangross/skillforge-claude-plugin.