Ce tipuri de răspuns poți returna în afara JSON?

Question

Accepted Answer

FastAPI returnează JSON implicit (serializând dicts, liste și modele Pydantic), dar suportă multe alte **response types** pentru nevoi diferite — HTML, fișiere, fluxuri, redirectări și text simplu — prin clasele `fastapi.responses`. ## Clasele de răspuns implicite și comune ```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 ``` ## Servind fișiere ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` servește eficient un fișier de pe disc (gestionând headere, tipul de conținut) — pentru descărcări, imagini, documente generate. ## Transmiterea datelor mari sau generate ```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` trimite date incremental dintr-un generator — esențial pentru **date mari sau continuu generate** (fișiere mari, exporturi CSV, fluxuri live) pentru a nu încărca totul în memorie deodată. (De asemenea baza pentru Server-Sent Events.) ## Codificatoare JSON personalizate (JSON mai rapid) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## De ce este important De-și JSON acoperă majoritatea răspunsurilor API, aplicațiile reale adesea trebuie să returneze alt conținut — și cunoașterea response types ale FastAPI te permite să le gestionezi corect. **`FileResponse`** este necesar pentru servirea fișierelor și descărcărilor (rapoarte, imagini, documente generate), **`StreamingResponse`** este important pentru livrarea **eficientă în memorie** a datelor mari sau continuu generate (exporturi mari, streaming de fișiere, server-sent events — cedând bucăți în loc să bufarizezi totul în memorie, ceea ce contează pentru scalabilitate), iar `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` gestionează conținut non-JSON și navigare. Înțelegerea response types-urilor disponibile și în special când să **transmiti** (pentru date mari, pentru a evita epuizarea memoriei) versus a returna JSON este cunoștință practică pentru construirea API-urilor care depășesc endpoint-urile JSON simple — acoperind descărcări de fișiere, exporturi de date și răspunsuri mari sau în timp real care sunt cerințe obișnuite în aplicațiile din lumea reală.