API Versioning

Referentiepatronen voor versiebeheer, deprecation en migratie van REST API's zonder clients te breken.

Door wpank · wpank/ai

Getest · Werkt ★ 9.2/10

API Versioning — Referentiepatronen voor versiebeheer, deprecation en migratie van REST API's zonder clients te breken.

Wat het doet

Een pure-kennis skill die API versiebeheer strategieën (URL pad, header, query parameter, content negotiatie), breaking-change classificatie, deprecation tijdlijnen, en migratiepatronen (adapter/facade) behandelt. Triggers bij het evolueren van een API, plannen van een breaking change, of beheren van versie/deprecation levenscycli.

Testrapport

Toegepast op een echt breaking-change scenario (veld hernoemen, auth wijzigen), produceerde het een exacte RFC 8594 Sunset-header specificatie, een 410-Gone JSON body, en een concrete 12-maanden publieke API deprecation minimum — een generieke baseline deed alleen een suggestie voor 'communiceer de wijziging' zonder enige van dat.

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

Installatie

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

Commando's en voorbeeldprompts

/api-versioningReferentiepatronen voor versiebeheer, deprecation en migratie van REST API's zonder clients te breken.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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?

Volledig rapport (Engels) →