API Versioning

Referensmönster för versionering, avveckling och migrering av REST API:er utan att bryta klienter.

av wpank · wpank/ai

Testad · Fungerar ★ 9.2/10

API Versioning — Referensmönster för versionering, avveckling och migrering av REST API:er utan att bryta klienter.

Vad den gör

En ren kunskapsfärdighet som täcker API-versionsstrategier (URL-sökväg, header, frågeparameter, innehållsförhandling), klassificering av brytande ändringar, avvecklingstidslinjer och migreringsmönster (adapter/fasad). Triggers vid utveckling av ett API, planering av en brytande ändring eller hantering av versions-/avvecklingslivscykler.

Testrapport

Tillämpad på ett verkligt scenario med brytande ändringar (byt namn på ett fält, ändra autentisering), producerade den en exakt RFC 8594 Sunset-header-specifikation, en 410-Gone JSON-kropp och ett konkret 12-månaders minimum för offentlig API-avveckling -- en generisk baslinje gestikulerade bara 'kommunicera ändringen' utan något av detta.

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

Kommandon och exempelprompter

/api-versioningReferensmönster för versionering, avveckling och migrering av REST API:er utan att bryta klienter.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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 hela rapporten →