likkisai59/spond/api-versioning-standards

Claude Code and agent skill by likkisai59/spond

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

API versioning standards and approaches for RESTful services with URL path, header, and query parameter strategies

Install

npx vskill@latest install likkisai59/spond/api-versioning-standards

SKILL.md

The same SKILL.md was published earlier as likkisai59/spond/api-versioning-standards.

API Versioning Standards Skill

Versioning Approaches

URL Path Versioning (Recommended)
/api/v1/orders
/api/v2/orders
python
from fastapi import APIRouter
v1_router = APIRouter(prefix="/api/v1")
v2_router = APIRouter(prefix="/api/v2")
Header Versioning
Accept: application/vnd.api+json;version=1
Query Parameter
/api/orders?version=1

FastAPI Implementation

python
# app/api/v1/router.py
v1_router = APIRouter()
v1_router.include_router(orders_router)
v1_router.include_router(webhooks_router)
# app/api/v2/router.py
v2_router = APIRouter()
v2_router.include_router(orders_router_v2)
# app/main.py
app.include_router(v1_router)
app.include_router(v2_router)

Versioning Rules

  • Major version (v1 → v2): Breaking changes
  • Non-breaking: Add optional fields, new endpoints
  • Deprecation: Support old version for 6+ months

Best Practices

  1. Use URL path versioning for clarity
  2. Maintain all versions until deprecation
  3. Document version differences
  4. Include version in error responses
  5. Plan migration path for users

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/likkisai59/spond/api-versioning-standards/badge)](https://verified-skill.com/skills/likkisai59/spond/api-versioning-standards)

Something wrong with this skill or its page? Tell us.