API Versioning

Reference-mønstre for versionering, deaktivering og migrering af REST API'er uden at bryde klienter.

Af wpank · wpank/ai

Testet · Virker ★ 9.2/10

API Versioning — Reference-mønstre for versionering, deaktivering og migrering af REST API'er uden at bryde klienter.

Hvad det gør

En ren videns-færdighed, der dækker API-versioneringsstrategier (URL-sti, header, query-parameter, indholdsforhandling), klassificering af brudte ændringer, deaktiveringstidslinjer og migrationsmønstre (adapter/facade). Udløses, når en API udvikles, en brudt ændring planlægges, eller versions-/deaktiveringslivscykler administreres.

Testrapport

Anvendt på et reelt brudt-ændringsscenarie (omdøb et felt, ændr godkendelse), producerede den en præcis RFC 8594 Sunset-header spec, en 410-Gone JSON-body og et konkret 12-måneders offentlig-API deaktiveringsminimum -- et generisk basis-svar gestikulerede kun 'kommuniker ændringen' uden noget af det.

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

Installation

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-versioningReference-mønstre for versionering, deaktivering og migrering af REST API'er uden at bryde klienter.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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?

Læs hele rapporten →