guides

API Development

Build high-performance REST and GraphQL APIs with compiled Python.

Published May 30, 2026

REST API Patterns

def handle_request(payload: dict) -> dict:
    validated = validate_input(payload)
    result = compute_result(validated)
    return format_response(result)

GraphQL Resolvers

def resolve_orders(customer_id: int) -> list[dict]:
    rows = db.query(customer_id)
    orders = []
    for row in rows:
        orders.append({
            'id': row['id'],
            'total': row['price'] * row['quantity']
        })
    return orders

Request Validation

def validate_pagination(params: dict) -> tuple[int, int]:
    page = max(1, int(params.get('page', 1)))
    size = min(100, max(1, int(params.get('size', 20))))
    return page, size