Katere vrste odgovorov lahko vrneš drugače kot JSON?

Question

Accepted Answer

FastAPI privzeto vrne JSON (serializira dict, list in Pydantic modele), vendar podpira številne druge **vrste odgovorov** za različne potrebe — HTML, datoteke, tokove, preusmeritve in navadno besedilo — preko razredov `fastapi.responses`. ## Privzete in pogosto uporabljane razrede odgovorov ```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 ``` ## Serviraje datoteka ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` učinkovito servira datoteko z diska (upravljanje glav, tip vsebine) — za prenose, slike, generirane dokumente. ## Pretakanje velikih ali generiranih podatkov ```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` pošilja podatke postopoma iz generatorja — bistveno za **velike ali neprekinjeno generirane** podatke (velike datoteke, CSV izvozi, živi viri), da jih ne naložiš vse naenkrat v pomnilnik. (Tudi osnova Server-Sent Events.) ## Prilagojeni JSON kodirniki (hitrejši JSON) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## Zakaj je to pomembno Čeprav JSON pokriva večino odgovorov API-ja, prave aplikacije pogosto morajo vrniti drugo vsebino — poznavanje FastAPI tipov odgovorov ti omogoča, da jih pravilno obvoziš. **`FileResponse`** je potreben za serviraje datoteken in prenose (poročila, slike, generirani dokumenti), **`StreamingResponse`** je pomemben za **varčevanje s pomnilnikom** pri dostavi velikih ali neprekinjeno generiranih podatkov (veliki izvozi, pretakanje datotek, server-sent events — ustvarjanje gradnikov namesto predpomnilnika vsega, kar je pomembno za razširljivost), in `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` upravljajo ne-JSON vsebino in navigacijo. Razumevanje razpoložljivih vrst odgovorov in še posebej kdaj **pretakati** (za velike podatke, da se izogneš izčrpavanju pomnilnika) v primerjavi z vrnitvijo JSON je praktično znanje za gradnjo API-jev, ki gredo čez preprostišnje JSON končne točke — pokrivanje prenosov datotek, izvozov podatkov in velikih ali realnih odgovorov, ki so splošne zahteve v aplikacijah v resničnem svetu.