api-versioning

SKILL.md

| 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:

Stratégies de gestion des versions d'API, y compris le chemin d'URL, l'en-tête et la négociation de contenu. À utiliser lors de la migration de la v1 vers la v2, de la gestion des modifications avec rupture, de la mise en œuvre de politiques de dépréciation ou de temporisation ou de la gestion de la compatibilité ascendante. Source : yonatangross/orchestkit.

Voir l'original