Request & Response Handling

Learn how to work with HTTP requests and responses in Sufast applications.

Request Object

Access request data, headers, and metadata

Request Properties

Property	Type	Description
request.method	str	HTTP method (GET, POST, etc.)
request.url	URL	Complete request URL
request.headers	Headers	Request headers dictionary
request.query_params	QueryParams	URL query parameters
request.path_params	dict	Path parameters from URL
request.client	Address	Client IP and port

Request Methods

Method	Return Type	Description
await request.body()	bytes	Raw request body
await request.json()	dict	Parse JSON body
await request.form()	FormData	Parse form data
request.cookies	dict	Request cookies

Basic Request Usage

Request Usagepython

from sufast import App, Request

app = App()

@app.post("/users")
async def create_user(request: Request):
    # Access request metadata
    method = request.method  # "POST"
    path = request.url.path  # "/users"
    client_ip = request.client.host
    
    # Access headers
    content_type = request.headers.get("content-type")
    user_agent = request.headers.get("user-agent")
    
    # Parse JSON body
    user_data = await request.json()
    
    return {
        "message": "User created",
        "data": user_data,
        "client_ip": client_ip,
        "content_type": content_type
    }