Çfarë llojesh përgjigjesh mund të ktheni përtej JSON?

Question

Accepted Answer

FastAPI kthen JSON si parazgjedhje (duke serializuar dicts, lists, dhe Pydantic models), por ai suporton shumë lloje të tjera **përgjigje** për nevoja të ndryshme — HTML, skedarë, streams, ridrejtime, dhe tekst të thjeshtë — përmes klasave `fastapi.responses`. ## Klasat e përgjigjeve të parazgjedhura dhe të zakonshme ```python from fastapi.responses import ( JSONResponse, HTMLResponse, PlainTextResponse, RedirectResponse, FileResponse, StreamingResponse, ) @app.get("/json") def j(): return {"key": "value"} # default → JSON @app.get("/html", response_class=HTMLResponse) def h(): return "

Hello

" # serve HTML @app.get("/text", response_class=PlainTextResponse) def t(): return "plain text" @app.get("/go") def g(): return RedirectResponse(url="/new-location") # 307 redirect ``` ## Shërbimi i skedarëve ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` shërben në mënyrë efikase një skedar nga disku (duke trajtuar headerët, llojin e përmbajtjes) — për shkarkim, imazhe, dokumente të gjeneruar. ## Rrymim i të dhënave të mëdha ose të gjeneruara ```python @app.get("/stream") def stream(): def generate(): for i in range(1000000): yield f"line {i} " # yield chunks — NOT all loaded into memory return StreamingResponse(generate(), media_type="text/plain") ``` `StreamingResponse` dërgon të dhëna në mënyrë graduale nga një gjenerator — esenciale për **të dhëna të mëdha ose të gjeneruara vazhdimisht** (skedarë të mëdhenj, eksporte CSV, feeds live) kështu që nuk i ngarkoj të gjithë në kujtesë njëherësh. (Gjithashtu baza e Server-Sent Events.) ## Kodues të personalizuar JSON (JSON më i shpejtë) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## Pse është e rëndësishme Ndërsa JSON mbuloi shumicën e përgjigjeve të API, aplikacionet e vërteta shpesh duhet të kthejnë përmbajtje të tjera — dhe njohja e llojeve të përgjigjeve të FastAPI ju lejon të trajtatni këto në mënyrë të saktë. **`FileResponse`** është e nevojshme për shërbimin e skedarëve dhe shkarkim (raporte, imazhe, dokumente të gjeneruar), **`StreamingResponse`** është e rëndësishme për dorëzimin **efikase në kujtesë** të të dhënave të mëdha ose të gjeneruara vazhdimisht (eksporte të mëdha, rrymim skedarësh, ngjarje të serveru — duke dhënë copa në vend të tamponimit të gjithçkaje në kujtesë, e cila është e rëndësishme për skalabilitet), dhe `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` trajtojnë përmbajtje jo-JSON dhe lundim. Njohja e llojeve të përgjigjeve të disponueshme dhe veçanërisht kur duhet të **rrymoni** (për të dhëna të mëdha, për të shmangur shterrimin e kujtesës) ndaj kthimit të JSON është njohuri praktike për ndërtimin e API-ve që shkojnë përtej pikave të thjeshta të JSON — që mbulojnë shkarkim skedarësh, eksporte të dhënash, dhe përgjigjeve të mëdha ose në kohë reale që janë kërkesa të zakonshme në aplikacionet e botës reale.