API Versioning

Pattern di riferimento per versionare, deprecate e migrare API REST senza interrompere i client.

di wpank · wpank/ai

Promosso ★ 9.2/10

API Versioning — Pattern di riferimento per versionare, deprecate e migrare API REST senza interrompere i client.

Cosa fa

Una skill puramente informativa che copre strategie di versionamento API (percorso URL, header, parametro query, negoziazione contenuto), classificazione dei breaking change, tempistiche di deprecazione e pattern di migrazione (adapter/facade). Si attiva quando si evolve un'API, si pianifica un breaking change o si gestiscono cicli di vita di versionamento/deprecazione.

Rapporto di test

Applicata a un vero scenario di breaking change (rinominare un campo, cambiare autenticazione), ha prodotto una specifica esatta dell'header RFC 8594 Sunset, un corpo JSON 410-Gone e un minimo concreto di 12 mesi di deprecazione API pubblica — una baseline generica ha solo accennato a 'comunicare il cambiamento' senza nulla di tutto ciò.

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

Installazione

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

Comandi e prompt di esempio

/api-versioningPattern di riferimento per versionare, deprecate e migrare API REST senza interrompere i client.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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?

Rapporto completo →