API Versioning

Referansemønstre for versjonering, deaktivering og migrering av REST API-er uten å bryte klienter.

av wpank · wpank/ai

Bestått ★ 9.2/10

API Versioning — Referansemønstre for versjonering, deaktivering og migrering av REST API-er uten å bryte klienter.

Hva den gjør

En ren kunnskapsferdighet som dekker API-versjoneringsstrategier (URL-bane, header, spørreparameter, innholdsforhandling), klassifisering av brytende endringer, deaktiveringstidslinjer og migreringsmønstre (adapter/fasade). Utløses ved utvikling av et API, planlegging av en brytende endring, eller administrasjon av versjons/deaktiveringslivssykluser.

Testrapport

Anvendt på et reelt brytende endringsscenario (endre navn på et felt, endre autentisering), produserte den en nøyaktig RFC 8594 Sunset-header spesifikasjon, en 410-Gone JSON-kropp, og et konkret 12-måneders minimum for offentlig API-deaktivering — en generisk grunnlinje gestikulerte bare 'kommuniser endringen' uten noe av dette.

Testet på: 2026-07-16 · Claude Code 2.x (agent harness)

Installer

git clone https://github.com/wpank/ai
mkdir -p ~/.claude/skills
cp -r ai/skills/api/api-versioning ~/.claude/skills/api-versioning

Kommandoer og eksempelprompter

/api-versioningReferansemønstre for versjonering, deaktivering og migrering av REST API-er uten å bryte klienter.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

How should I version this REST API before renaming a response field?
Write a deprecation timeline for sunsetting our old API auth method
What's the best way to roll out a breaking API change without upset?

Full rapport →