Obiectul Request în FastAPI în FastAPI

Deși FastAPI încurajează extragerea declarativă a parametrilor prin Pydantic sau adnotări specifice, există situații în care ai nevoie de acces direct la obiectul de cerere HTTP de nivel jos: inspectarea adresei IP a clientului, citirea schemei de conexiune (HTTP/HTTPS) sau accesarea dicționarului request.state.

Declarând un parametru cu tipul Request (importat din fastapi), framework-ul injectează automat instanța Starlette a cererii curente.

from fastapi import FastAPI, Request

app = FastAPI()

@app.get("/client-info")
async def get_client_info(request: Request):
    client_host = request.client.host if request.client else "Necunoscut"
    user_agent = request.headers.get("user-agent", "Necunoscut")
    
    return {
        "client_ip": client_host,
        "method": request.method,
        "url": str(request.url),
        "user_agent": user_agent
    }