FastAPI Middleware

pip install xenarch[fastapi]

from fastapi import FastAPI
from xenarch.middleware import XenarchMiddleware

app = FastAPI()

app.add_middleware(
    XenarchMiddleware,
    site_token="st_...",
    site_id="your-site-uuid",
    access_token_secret="your_secret",
    excluded_paths={"/healthz", "/docs", "/openapi.json"},
)

@app.get("/articles")
async def articles():
    return {"articles": [...]}

from fastapi import FastAPI, Request
from xenarch.decorator import require_payment

app = FastAPI()

gate = require_payment(
    site_token="st_...",
    site_id="your-site-uuid",
    access_token_secret="your_secret",
)

@app.get("/")
async def home():
    """Free for everyone."""
    return {"message": "Welcome"}

@app.get("/premium")
@gate
async def premium(request: Request):
    """Gated — bots must pay."""
    return {"content": "premium data"}

Human request     → passes through (zero overhead)
Bot + valid token → passes through
Bot + no token    → HTTP 402 with payment gate

# Human request — passes through
curl http://localhost:8000/articles

# Bot without token — 402
curl -H "User-Agent: GPTBot/1.0" http://localhost:8000/articles

# Bot with token — passes through
curl -H "User-Agent: GPTBot/1.0" \
     -H "Authorization: Bearer eyJ..." \
     http://localhost:8000/articles