API Versioning

Referenzmuster für Versionierung, Deprecating und Migration von REST-APIs ohne Client-Unterbrechung.

von wpank · wpank/ai

Getestet · Funktioniert ★ 9.2/10

API Versioning — Referenzmuster für Versionierung, Deprecating und Migration von REST-APIs ohne Client-Unterbrechung.

Was es kann

Ein reiner Wissens-Skill, der API-Versioning-Strategien (URL-Pfad, Header, Query-Parameter, Content Negotiation), Klassifizierung von Breaking Changes, Deprecating-Zeitpläne und Migrationsmuster (Adapter/Facade) abdeckt. Wird ausgelöst, wenn eine API weiterentwickelt, ein Breaking Change geplant oder Lebenszyklen von Versionen/Deprecations verwaltet werden.

Testbericht

Angewendet auf ein echtes Breaking-Change-Szenario (Umbenennung eines Feldes, Änderung der Authentifizierung) erzeugte es eine exakte RFC 8594 Sunset-Header-Spezifikation, einen 410-Gone JSON-Body und ein konkretes 12-monatiges Public-API-Deprecating-Minimum – eine generische Basisantwort deutete nur 'die Änderung kommunizieren' an, ohne all das.

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

Befehle & Beispiel-Prompts

/api-versioningReferenzmuster für Versionierung, Deprecating und Migration von REST-APIs ohne Client-Unterbrechung.

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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?

Vollständiger Testbericht (Englisch) →