Backend API Routes Skill

What problem does it solve?

This Skill standardizes how backend API routes are built in FastAPI projects, ensuring consistent structure, security, and maintainability across services.

Core Features & Use Cases

• Uniform route patterns: Enforce use of APIRouter with a common /api prefix, and standardized tagging for OpenAPI.
• Dependency injection: Promote automatic management of database sessions via FastAPI Depends.
• Security & validation: Enforce JWT-based authentication, path/query validation with Pydantic models, and consistent error handling.
• Service layer alignment: Encourage delegating business logic to service modules to separate concerns.

Quick Start

Create a new route by following the documented patterns. Example: define a router in backend/routes, apply APIRouter(prefix="/api"), add dependencies (db: Session = Depends(get_db), current_user: dict = Depends(verify_jwt_token)), validate inputs with Pydantic models, and return a standardized response. Then wire the router into the application.