REST API Starter

REST API Starter

Production-ready REST API server built on Python's standard library. Zero dependencies.

Part of the API Launchpad toolkit by [CodeVault](https://codevault.dev).

Features

• Declarative routing with path parameters (/users/{id}) and type coercion
• Middleware pipeline: logging, CORS, timing — add your own in one line
• RFC 7807 error responses — structured JSON errors that clients can parse
• Auto-generated OpenAPI 3.0 spec from your route definitions
• Request validation with JSON body parsing and type checking
• Zero dependencies — runs on Python stdlib only

Quick Start

# Start the server
python3 src/main.py

# Test it
curl http://localhost:8000/items
curl http://localhost:8000/items/1
curl -X POST http://localhost:8000/items -d '{"name":"New Item","price":5.99}'
curl http://localhost:8000/openapi.json

Adding Your Own Routes

from main import router, Response, Request

@router.get("/users/{user_id}", summary="Get user", tags=["users"])
def get_user(request: Request) -> Response:
    user_id = request.path_params["user_id"]
    return Response(body={"id": user_id, "name": "Acme User"})

@router.post("/users", summary="Create user", tags=["users"])
def create_user(request: Request) -> Response:
    data = request.json()
    return Response(status=201, body={"id": "4", **data})

Adding Middleware

def auth_middleware(request, next_handler):
    api_key = request.headers.get("x-api-key")
    if not api_key:
        raise APIError(401, "Unauthorized", "Missing X-API-Key header")
    return next_handler(request)

Configuration

See examples/config.example.json for all available options.

... continues with setup instructions, usage examples, and more.